{"api_version":"1.0.0","tier":"free","available_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":"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"}],"supported_locales":[{"code":"en_US","name":"English (United States)"},{"code":"en_AE","name":"English (UAE)","notes":"Phone requires country_code +971"},{"code":"en_GB","name":"English (United Kingdom)"},{"code":"ar_AE","name":"Arabic (UAE)"}],"limits":{"max_records_per_call":100,"max_calls_per_day":20,"max_ai_records_per_call":100,"allowed_field_categories":"all","nested_depth":1,"agentic_hints":true,"rag_access":false,"price_usd_month":0},"example_requests":[{"description":"UAE customer records with locale-correct phone","request":{"schema":[{"name":"full_name","type":"firstName"},{"name":"email","type":"email"},{"name":"phone","type":"phone","constraints":{"country_code":"+971"}}],"recordCount":10,"locale":"en_AE","exportFormat":"json"}},{"description":"Financial transaction records","request":{"schema":[{"name":"transaction_id","type":"transactionId"},{"name":"amount","type":"transactionAmount"},{"name":"iban","type":"iban","constraints":{"country_prefix":"AE"}},{"name":"status","type":"paymentStatus"}],"recordCount":50,"locale":"en_AE","exportFormat":"jsonl"}},{"description":"AI mode: only column names; types and values inferred (POST /api/v1/generate-ai)","request":{"field_names":["customer_email","order_total_usd","ship_date","flavor_sku"],"count":25,"locale":"en_US","output_format":"json"}}],"payment_options":{"api_key":{"description":"Monthly tier subscription. Get free key at /api/v1/auth/free-key.","tiers":{"free":{"price_usd_month":0,"max_records":100},"pro":{"price_usd_month":29,"max_records":5000},"enterprise":{"price_usd_month":199,"max_records":100000}}},"x402":{"description":"Pay per call in USDC on the configured L2 (default Base Sepolia testnet). No account needed.","pricing":{"generate_small":2000,"generate_medium":5000,"generate_large":15000,"validate":0,"capabilities":0},"how_it_works":"Omit X-API-Key. Server returns 402. Pay. Retry with X-PAYMENT header."}},"payment_environment":{"datagen_env":"development","agentic":{"lineage_enabled_static":false,"lineage_stage":"staging","escrow_middleware_enabled_static":false,"escrow_canary_path":"/api/v1/canary/generate"},"x402":{"protocol":"HTTP 402 + X-PAYMENT (x402 facilitator)","network_id_string":"base-sepolia","facilitator_base_url":"https://x402.org","facilitator_verify_path":"https://x402.org/verify","facilitator_settle_path":"https://x402.org/settle","usdc_contract":"0x036CbD53842c5426634e7929541eC2318f3dCF7e","pay_to_configured":true,"pay_to_masked":"0x9370…8b18","protected_paths":["/api/v1/generate","/api/v1/generate-ai","/api/v1/generate-ai/stream"],"pricing_micro_usdc_brackets":{"generate_small":2000,"generate_medium":5000,"generate_large":15000,"validate":0,"capabilities":0},"example_quote_count_10_micro_usdc":2000,"example_quote_count_500_micro_usdc":5000,"notes":"Omit X-API-Key on protected paths to receive 402 JSON with `accepts[]`. Retry the same URL and body with header X-PAYMENT set to the facilitator-verified payload."},"escrow_canary_invoice":{"active_when":"AGENTIC_ESCROW_ENABLED=1 and keyless POST on escrow_canary_path (before x402; canary is not an x402 protected path).","chain_id":84532,"chain_human":"base-sepolia","usdc_contract":"0x036CbD53842c5426634e7929541eC2318f3dCF7e","escrow_contract_configured":true,"escrow_contract_masked":"0x9314…79e8","payee_wallet_configured":false,"payee_wallet_masked":"(unset)","response_header":"X-Payment-Required: true on the invoice 402"}}}