{"api_version":"1.0.0","description":"Canonical synthetic field types supported by DataGen APIs. Use the 'name' value as JSON 'type' on each schema field. AI mode (POST /api/v1/generate-ai) may infer these types from column names.","type_count":70,"field_types":[{"name":"firstName","category":"personal","description":"Given name for the request locale.","example_value":"Layla","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"lastName","category":"personal","description":"Family name for the request locale.","example_value":"Al-Mansoori","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"middleName","category":"personal","description":"Middle name or patronymic.","example_value":"James","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"fullName","category":"personal","description":"Full display name combining parts.","example_value":"Layla Al-Mansoori","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"email","category":"personal","description":"Email address.","example_value":"sarah.jones@gmail.com","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"phone","category":"personal","description":"Phone number; en_AE requires constraints.country_code '+971'.","example_value":"+971 50 123 4567","required_constraints":[],"locale_notes":"en_AE: add constraints: {'country_code': '+971'}","tier_required":"free"},{"name":"address","category":"personal","description":"Street / postal address.","example_value":"Sheikh Zayed Road, Dubai, UAE","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"birthdate","category":"personal","description":"Date of birth (ISO date).","example_value":"1992-04-18","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"gender","category":"personal","description":"Gender label for synthetic personas.","example_value":"Female","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"age","category":"personal","description":"Integer age in years.","example_value":"34","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"nationality","category":"personal","description":"Nationality or citizenship label.","example_value":"UAE","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"country","category":"geographic","description":"Country name.","example_value":"United Arab Emirates","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"city","category":"geographic","description":"City or locality name.","example_value":"Dubai","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"state","category":"geographic","description":"State / emirate / province.","example_value":"Dubai","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"zipCode","category":"geographic","description":"Postal or ZIP code.","example_value":"00000","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"region","category":"geographic","description":"Region, territory, or macro-area.","example_value":"GCC","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"latitude","category":"geographic","description":"Decimal latitude.","example_value":"25.2048","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"longitude","category":"geographic","description":"Decimal longitude.","example_value":"55.2708","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"timezone","category":"geographic","description":"IANA-style timezone name.","example_value":"Asia/Dubai","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"company","category":"business","description":"Company or legal entity name.","example_value":"Emirates Logistics LLC","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"jobTitle","category":"business","description":"Professional job title.","example_value":"Senior Data Engineer","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"department","category":"business","description":"Department or cost-center label.","example_value":"Finance Operations","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"industry","category":"business","description":"Industry vertical.","example_value":"Retail","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"occupation","category":"business","description":"Occupation description.","example_value":"Store manager","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"employeeId","category":"business","description":"Internal employee identifier.","example_value":"EMP-88421","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"website","category":"technical","description":"HTTP(S) URL.","example_value":"https://example.com/about","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"url","category":"technical","description":"Generic URL string.","example_value":"https://cdn.example.com/asset.png","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"username","category":"technical","description":"Login or handle.","example_value":"dev_marina_03","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"uuid","category":"technical","description":"UUID v4.","example_value":"550e8400-e29b-41d4-a716-446655440000","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"ipAddress","category":"technical","description":"IPv4 address.","example_value":"203.0.113.42","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"macAddress","category":"technical","description":"MAC address style identifier.","example_value":"00:1A:2B:3C:4D:5E","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"userAgent","category":"technical","description":"Browser or client user-agent string.","example_value":"Mozilla/5.0 …","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"color","category":"product","description":"Color name or hex.","example_value":"#3B82F6","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"language","category":"product","description":"Human language name or BCP-47 tag.","example_value":"en-AE","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"brandName","category":"product","description":"Brand or product line name.","example_value":"Alpine Scoops","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"productName","category":"product","description":"Product or SKU display name.","example_value":"Vanilla Bean Pint","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"sku","category":"product","description":"Stock keeping unit code.","example_value":"ICE-VAN-500ML","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"flavorName","category":"product","description":"Flavor or variant label (e.g. ice cream).","example_value":"Salted caramel","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"weightKg","category":"numbers","description":"Weight in kilograms (decimal).","example_value":"0.5","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"heightCm","category":"numbers","description":"Height in centimeters.","example_value":"178","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"bloodType","category":"personal","description":"Blood type label.","example_value":"O+","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"passportNumber","category":"personal","description":"Synthetic passport-style identifier.","example_value":"N1234567","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"driversLicense","category":"personal","description":"Synthetic driver license number.","example_value":"D123-456-7890","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"ssnLastFour","category":"personal","description":"Last four digits style token (synthetic).","example_value":"7281","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"creditCard","category":"financial","description":"Card number with Luhn checksum (synthetic).","example_value":"4532 1234 5678 9012","required_constraints":[],"locale_notes":null,"tier_required":"pro"},{"name":"currency","category":"financial","description":"ISO 4217 currency code.","example_value":"AED","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"amount","category":"financial","description":"Monetary amount.","example_value":"1250.50","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"iban","category":"financial","description":"IBAN; en_AE often needs constraints.country_prefix 'AE'.","example_value":"AE070331234567890123456","required_constraints":[],"locale_notes":"en_AE: {'country_prefix': 'AE'}","tier_required":"free"},{"name":"accountNumber","category":"financial","description":"Bank account number (synthetic).","example_value":"0192837465","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"bankName","category":"financial","description":"Bank or institution name.","example_value":"First Gulf Bank","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"swiftCode","category":"financial","description":"SWIFT / BIC style code.","example_value":"FABADAAI","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"invoiceNumber","category":"financial","description":"Invoice or document number.","example_value":"INV-2026-004512","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"taxId","category":"financial","description":"Tax or VAT style identifier.","example_value":"100123456700003","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"ledgerCode","category":"financial","description":"General ledger code.","example_value":"6200-TRAVEL","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"costCenter","category":"financial","description":"Cost center code.","example_value":"CC-AE-441","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"transactionId","category":"financial","description":"Transaction reference.","example_value":"txn_9f2c8b1a4d3e","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"transactionAmount","category":"financial","description":"Signed transaction amount.","example_value":"-49.99","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"paymentStatus","category":"financial","description":"Payment lifecycle status.","example_value":"CAPTURED","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"orderNumber","category":"product","description":"Customer-visible order number.","example_value":"ORD-2026-88321","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"shipmentStatus","category":"product","description":"Shipment / fulfillment status.","example_value":"OUT_FOR_DELIVERY","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"shipmentTrackingId","category":"product","description":"Carrier tracking identifier.","example_value":"1Z999AA10123456784","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"reviewScore","category":"numbers","description":"Rating or score (often 1–5 or 0–100).","example_value":"4.7","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"date","category":"dates","description":"Calendar date ISO YYYY-MM-DD.","example_value":"2026-01-15","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"dateTime","category":"dates","description":"ISO-8601 timestamp.","example_value":"2026-01-15T14:32:11+04:00","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"integer","category":"numbers","description":"Random integer.","example_value":"8421","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"decimal","category":"numbers","description":"Decimal number.","example_value":"384.27","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"percentage","category":"numbers","description":"Percentage 0–100.","example_value":"37.5","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"text","category":"freeform","description":"Short free-text phrase or label.","example_value":"Customer prefers morning delivery","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"notes","category":"freeform","description":"Longer free-text notes.","example_value":"Called back to confirm address.","required_constraints":[],"locale_notes":null,"tier_required":"free"},{"name":"tags","category":"freeform","description":"Comma-separated or single-line tags.","example_value":"vip, recurring, uae","required_constraints":[],"locale_notes":null,"tier_required":"free"}],"locale_rules_summary":{"en_AE":"phone requires constraints.country_code '+971'; iban often needs country_prefix 'AE'.","ar_AE":"Same phone and iban constraints as en_AE."}}