{
  "name": "Airwallex Payouts",
  "slug": "airwallex-payouts",
  "website_url": "https://www.airwallex.com/us/platform-api-and-embedded-finance/payouts",
  "vendor_description": "\"Fast, programmatic international and domestic payouts\"",
  "categories": [
    "payouts"
  ],
  "summary": "Airwallex Payouts is a REST API for programmatic domestic and international disbursements, covering use cases from marketplace seller payouts and freelancer payments to global payroll and cross-border withdrawals. It reaches 200+ countries and regions across 90+ currencies, using local clearing rails in 120+ countries alongside SWIFT, ACH, and SEPA. Pricing is not published and requires a sales conversation; SWIFT transfers cost $15 to $25 each, and FX conversion carries a 0.5% to 1% markup over interbank rates. The API supports API key and OAuth2 auth, webhooks, idempotency, and a sandbox, with SDKs for Node.js, iOS, Android, Flutter, and React Native.",
  "capabilities": {
    "supported_actions": [
      "create_payout",
      "batch_payouts",
      "beneficiary_onboarding",
      "beneficiary_validation",
      "get_api_schema",
      "get_form_schema",
      "local_rails",
      "swift",
      "ach",
      "sepa",
      "wallet_payout",
      "fx_conversion",
      "recipient_onboarding",
      "kyc_kyb",
      "tax_form_collection",
      "1099_nec",
      "1099_k",
      "webhooks",
      "sandbox_simulation",
      "transfer_status_simulation",
      "connected_accounts",
      "embedded_components",
      "programmatic_account_creation",
      "transactional_fx"
    ],
    "supported_regions": [
      "120+ countries via local clearing systems",
      "150+ countries via SWIFT",
      "200+ countries and regions total",
      "90+ currencies"
    ],
    "supported_languages": [],
    "input_types": [
      "local bank rails",
      "SWIFT wire",
      "ACH",
      "SEPA",
      "PayPal wallet",
      "Airwallex in-network transfer"
    ],
    "output_types": [
      "JSON",
      "webhook events",
      "payment status",
      "reconciliation reports",
      "tax forms (1099-NEC, 1099-K)",
      "embedded UI components",
      "dynamic beneficiary schema"
    ],
    "webhooks_supported": true,
    "sandbox_available": true,
    "sdk_languages": [
      "Node.js",
      "JavaScript (browser)",
      "Android (Kotlin)",
      "iOS (Swift)",
      "Flutter (Dart)",
      "React Native"
    ],
    "mcp_server_available": true
  },
  "integration": {
    "api_style": "rest",
    "base_url": "https://api.airwallex.com/api/v1",
    "api_version": "2025-02-14",
    "versioning_scheme": "header",
    "stability": "beta",
    "deprecation_policy_url": null,
    "auth_methods": [
      "api_key",
      "oauth2"
    ],
    "auth_docs_url": "https://www.airwallex.com/docs/developer-tools/api/manage-api-keys",
    "idempotency_supported": true,
    "error_format": "vendor-specific",
    "webhook_signing": "hmac_sha256",
    "webhook_events_url": "https://www.airwallex.com/docs/developer-tools/webhooks/listen-for-webhook-events",
    "rate_limit_requests": 100,
    "rate_limit_window": "second",
    "sdk_packages": [
      {
        "package": "@airwallex/node-sdk",
        "language": "Node.js",
        "official": true,
        "repo_url": "https://www.npmjs.com/package/@airwallex/node-sdk"
      },
      {
        "package": "@airwallex/payouts-web-sdk",
        "language": "JavaScript (browser)",
        "official": true,
        "repo_url": "https://github.com/airwallex/payouts-web-sdk"
      },
      {
        "package": "airwallex-payment-android",
        "language": "Android (Kotlin)",
        "official": true,
        "repo_url": "https://github.com/airwallex/airwallex-payment-android"
      },
      {
        "package": "airwallex-payment-ios",
        "language": "iOS (Swift)",
        "official": true,
        "repo_url": "https://github.com/airwallex/airwallex-payment-ios"
      },
      {
        "package": "airwallex-payment-flutter",
        "language": "Flutter (Dart)",
        "official": true,
        "repo_url": "https://github.com/airwallex/airwallex-payment-flutter"
      },
      {
        "package": "airwallex-payment-react-native",
        "language": "React Native",
        "official": true,
        "repo_url": "https://github.com/airwallex/airwallex-payment-react-native"
      }
    ],
    "mcp_url": "https://mcp-demo.airwallex.com/developer",
    "quickstart_url": "https://www.airwallex.com/docs/payouts/how-airwallex-payouts-work"
  },
  "pricing": {
    "pricing_model": "contact_sales",
    "has_published_pricing": false,
    "starting_price_usd": null,
    "price_basis": null,
    "free_tier_available": false,
    "free_tier_limit": null,
    "free_tier_details": null,
    "minimum_commitment": null,
    "self_serve_signup": true,
    "requires_sales_call": true,
    "requires_verification": true,
    "enterprise_plan_available": true,
    "price_points": []
  },
  "compliance": {
    "soc2": "type_2",
    "hipaa": null,
    "gdpr": true,
    "iso_27001": true,
    "pci_dss": true,
    "sla_published": false,
    "sla_url": null,
    "data_retention_policy_url": "https://assets.ctfassets.net/e6wv1zvbwa49/6zfth37fc8aEAq9cbN0H6P/fe47f3216aea5737e858f9056ac08f08/Airwallex_-_Global_Privacy_Policy.pdf",
    "documented_rate_limits": "Production: 100 requests/second globally; 20 requests/second per endpoint; 50 concurrent requests maximum. Sandbox: 20 requests/second globally, 10/second per endpoint.",
    "known_restrictions": [
      "Holds 60+ global banking/regulatory licenses (MTL/EMI type licenses across jurisdictions)",
      "FX markup of 0.5% above interbank rates for major currencies (AUD, USD, HKD, CNY, EUR, GBP, SGD); 1% for all other currencies - these rates apply to business accounts and may differ for Platform API customers",
      "SWIFT transfers cost $15–$25 per transfer (SHA and OUR options); not free",
      "Platform API & Embedded Finance pricing requires contacting sales for custom pricing - no published rates for the embedded API product",
      "Tax form filing limited to 1099-K or 1099-NEC only; mixed filing not supported",
      "Server-side SDK currently in Beta (Node.js/TypeScript only)",
      "MCP server operates exclusively in sandbox environments for direct API testing"
    ]
  },
  "developer": {
    "docs_url": "https://dev.airwallex.com/global",
    "api_reference_url": "https://www.airwallex.com/docs/api#/Introduction",
    "openapi_spec_url": null,
    "postman_collection_url": null,
    "changelog_url": null,
    "status_page_url": "https://status.airwallex.com",
    "llms_txt_url": "https://www.airwallex.com/llms.txt",
    "markdown_docs_url": null,
    "rendering": "static"
  },
  "adoption": {
    "launched_at": "2015-01-01",
    "ga_date": null,
    "github_stars": null,
    "github_stars_at": null,
    "notable_customers": [
      "Brex",
      "Rippling",
      "Deel",
      "TikTok",
      "Canva",
      "Navan",
      "Papaya Global",
      "Afterpay",
      "SHEIN",
      "McLaren Racing"
    ]
  },
  "scores": {
    "agent_friendliness": 75,
    "pricing_transparency": 0,
    "setup_speed": 75,
    "docs_quality": 45,
    "procurement_friction": 25,
    "trust_readiness": 65,
    "best_for": [
      "Regulated or enterprise workloads - compliance attestations and an enterprise plan",
      "AI agents and automation - an agent-ready surface (MCP / llms.txt)",
      "Teams needing broad API coverage out of the box"
    ],
    "avoid_if": [
      "You need transparent pricing up front",
      "You want to try it free before paying"
    ]
  },
  "sources": [
    {
      "field": "vendor_description",
      "url": "https://www.airwallex.com/us/platform-api-and-embedded-finance/payouts",
      "excerpt": "Fast, programmatic international and domestic payouts",
      "confidence": "high"
    },
    {
      "field": "supported_regions",
      "url": "https://www.airwallex.com/us/platform-api-and-embedded-finance/payouts",
      "excerpt": "SWIFT transfers to 150+ countries and High-speed local transfers to 120+ countries",
      "confidence": "high"
    },
    {
      "field": "sdk_languages",
      "url": "https://www.airwallex.com/docs/developer-tools/sdks/mobile-sdks",
      "excerpt": "Flutter SDK — Flutter 3.24.3+ supporting iOS 13.0+ and Android API 21+; React Native SDK — React Native 0.79.3+ with iOS 13.0+ and Android API 21+ compatibility",
      "confidence": "high"
    },
    {
      "field": "pricing_model",
      "url": "https://www.airwallex.com/us/platform-api-and-embedded-finance",
      "excerpt": "Talk to our team to design the right solution for your business",
      "confidence": "high"
    },
    {
      "field": "free_tier_available",
      "url": "https://www.airwallex.com/en-us/pricing",
      "excerpt": "For Platform API & Embedded Finance use cases get in touch with us to discuss custom pricing",
      "confidence": "high"
    },
    {
      "field": "requires_sales_call",
      "url": "https://www.airwallex.com/us/platform-api-and-embedded-finance",
      "excerpt": "Talk to our team to design the right solution for your business",
      "confidence": "high"
    },
    {
      "field": "gdpr",
      "url": "https://security.airwallex.com/",
      "excerpt": "GDPR",
      "confidence": "high"
    },
    {
      "field": "pci_dss",
      "url": "https://security.airwallex.com/",
      "excerpt": "PCI DSS (Level 1 Service Provider - renewed); PCI-3DS (3D Secure) AOC Report",
      "confidence": "high"
    },
    {
      "field": "documented_rate_limits",
      "url": "https://www.airwallex.com/docs/developer-tools/api/rate-limits",
      "excerpt": "Production Environment: '100 requests per second' globally, '20 per second' per endpoint, '50' concurrent requests maximum",
      "confidence": "high"
    },
    {
      "field": "webhooks_supported",
      "url": "https://www.airwallex.com/docs/developer-tools/webhooks/listen-for-webhook-events",
      "excerpt": "Airwallex computes an HMAC with the SHA-256 hash function, using the notification URL's secret key as the key and a concatenated string (x-timestamp + JSON payload) as the message.",
      "confidence": "high"
    },
    {
      "field": "known_restrictions",
      "url": "https://www.airwallex.com/en-us/pricing",
      "excerpt": "0.5% above interbank rates for major currencies; 1% for all other currencies; SWIFT transfers: $15–$25 per transfer",
      "confidence": "high"
    },
    {
      "field": "input_types",
      "url": "https://www.airwallex.com/docs/payouts/payout-network",
      "excerpt": "Local payouts: Connections to local clearing systems in 120+ countries/regions; SWIFT payouts: Traditional international bank transfers; Digital wallet transfers: PayPal and Airwallex wallet support",
      "confidence": "high"
    },
    {
      "field": "self_serve_signup",
      "url": "https://www.airwallex.com/us/platform-api-and-embedded-finance/payouts",
      "excerpt": "Get started button and signup link at /en-us/signup",
      "confidence": "high"
    },
    {
      "field": "auth_methods",
      "url": "https://www.airwallex.com/docs/developer-tools/api/manage-api-keys",
      "excerpt": "To obtain an access token, submit a POST request to the authentication endpoint with these required headers: x-api-key: Your API key credential, x-client-id: Your associated client identifier",
      "confidence": "high"
    },
    {
      "field": "base_url",
      "url": "https://www.airwallex.com/docs/payouts/transfers/create-a-transfer",
      "excerpt": "The primary endpoint is: POST https://api-demo.airwallex.com/api/v1/transfers/create",
      "confidence": "high"
    },
    {
      "field": "api_version",
      "url": "https://www.airwallex.com/docs/developer-tools/sdks/server-side-sdks-(beta)",
      "excerpt": "The SDK is currently in Beta and supports API versions from 2025-02-14 onwards.",
      "confidence": "high"
    },
    {
      "field": "versioning_scheme",
      "url": "https://www.airwallex.com/docs/developer-tools/api",
      "excerpt": "You may override this version on a per call basis by setting the x-api-version header. This should only be used in exceptional cases, such as when testing and migrating to a newer version.",
      "confidence": "high"
    },
    {
      "field": "stability",
      "url": "https://www.airwallex.com/docs/developer-tools/sdks/server-side-sdks-(beta)",
      "excerpt": "The SDK is currently in Beta and supports API versions from 2025-02-14 onwards.",
      "confidence": "high"
    },
    {
      "field": "sdk_packages",
      "url": "https://github.com/airwallex/payouts-web-sdk",
      "excerpt": "sdk for hosted transfer — The SDK provides pre-built UI components including the Embedded Payout component and the Embedded Beneficiary component",
      "confidence": "high"
    },
    {
      "field": "quickstart_url",
      "url": "https://www.airwallex.com/docs/payouts/how-airwallex-payouts-work",
      "excerpt": "How Airwallex Payouts work — To get started, you can sign up for an Airwallex account or create a sandbox account to explore the product and test your integration.",
      "confidence": "medium"
    },
    {
      "field": "idempotency_supported",
      "url": "https://www.airwallex.com/docs/developer-tools/api",
      "excerpt": "The API implements idempotency using a request_id to prevent duplicate sessions from repeated requests. You should attach a unique request_id to each request, which allows your backend to recognize repeated requests as the same operation, ensuring idempotency.",
      "confidence": "high"
    },
    {
      "field": "error_format",
      "url": "https://www.airwallex.com/docs/developer-tools/api/rate-limits",
      "excerpt": "When exceeded, the API returns HTTP 429 (Too Many Requests) with a 'too_many_requests' error code.",
      "confidence": "medium"
    },
    {
      "field": "webhook_signing",
      "url": "https://www.airwallex.com/docs/developer-tools/webhooks/webhooks-overview",
      "excerpt": "Airwallex employs 'HMAC with the request timestamp and body' to sign webhook requests. You verify authenticity by comparing your computed signature against the one in the request header.",
      "confidence": "high"
    },
    {
      "field": "supported_regions",
      "url": "https://www.airwallex.com/docs/payouts/payout-network",
      "excerpt": "local and SWIFT payouts over 200 countries/regions and over 90 currencies, with connections to local clearing systems in over 120 countries",
      "confidence": "high"
    },
    {
      "field": "sdk_languages",
      "url": "https://www.airwallex.com/docs/developer-tools/sdks",
      "excerpt": "Airwallex.js — provides pre-built UI elements in the browser for payments acceptance, transfers, customer onboarding, and more; Mobile SDKs — Native implementations for iOS and Android platforms; server-side SDKs (currently available in Node.js)",
      "confidence": "high"
    },
    {
      "field": "pricing_model",
      "url": "https://www.airwallex.com/en-us/pricing",
      "excerpt": "For Platform API & Embedded Finance use cases get in touch with us to discuss custom pricing",
      "confidence": "high"
    },
    {
      "field": "has_published_pricing",
      "url": "https://www.airwallex.com/en-us/pricing",
      "excerpt": "For Platform API & Embedded Finance use cases get in touch with us to discuss custom pricing",
      "confidence": "high"
    },
    {
      "field": "requires_sales_call",
      "url": "https://www.airwallex.com/en-us/pricing",
      "excerpt": "For Platform API & Embedded Finance use cases get in touch with us to discuss custom pricing",
      "confidence": "high"
    },
    {
      "field": "soc2",
      "url": "https://security.airwallex.com/",
      "excerpt": "SOC 2 Type 1; SOC 2 Type 2",
      "confidence": "high"
    },
    {
      "field": "iso_27001",
      "url": "https://security.airwallex.com/",
      "excerpt": "ISO/IEC 27001",
      "confidence": "high"
    },
    {
      "field": "sla_published",
      "url": "https://security.airwallex.com/",
      "excerpt": "Airwallex is committed to upholding a strong security presence as well as complying with legal and regulatory requirements.",
      "confidence": "medium"
    },
    {
      "field": "mcp_server_available",
      "url": "https://www.airwallex.com/docs/developer-tools/ai/developer-mcp",
      "excerpt": "The Airwallex Developer Model Context Protocol (MCP) server empowers AI coding agents with the tools they need to assist developers integrating with Airwallex APIs",
      "confidence": "high"
    },
    {
      "field": "sandbox_available",
      "url": "https://www.airwallex.com/docs/developer-tools__quickstart",
      "excerpt": "Use Airwallex's sandbox environment to simulate transactions before going live",
      "confidence": "high"
    },
    {
      "field": "known_restrictions",
      "url": "https://www.airwallex.com/docs/payouts/tax-filing/us-tax-reporting",
      "excerpt": "We only support the filing of either 1099-K or 1099-NEC forms. Mixed filing is not currently supported",
      "confidence": "high"
    },
    {
      "field": "enterprise_plan_available",
      "url": "https://www.airwallex.com/en-us/pricing",
      "excerpt": "Accelerate: Custom pricing",
      "confidence": "high"
    },
    {
      "field": "primary_use_cases",
      "url": "https://www.airwallex.com/us/platform-api-and-embedded-finance/payouts",
      "excerpt": "Supplier and freelancer invoice payments; Global payroll and employee reimbursements; Marketplace seller/creator payouts; Customer-facing withdrawal and payout products",
      "confidence": "high"
    },
    {
      "field": "auth_methods",
      "url": "https://www.airwallex.com/docs/developer-tools/api",
      "excerpt": "OAuth is mentioned as part of 'Partner connections' functionality, with documentation on OAuth scopes, permissions, user roles, and authorization flow implementation available.",
      "confidence": "high"
    },
    {
      "field": "base_url",
      "url": "https://www.airwallex.com/docs/developer-tools/api",
      "excerpt": "When you're ready to switch to production, generate your production API keys by logging in to the Airwallex web app and update the API host in your API requests to https://api.airwallex.com/api/v1/",
      "confidence": "high"
    },
    {
      "field": "api_version",
      "url": "https://www.airwallex.com/docs/developer-tools/api",
      "excerpt": "Airwallex uses date-based versioning to introduce backwards incompatible API changes while ensuring that current integrations are not impacted.",
      "confidence": "high"
    },
    {
      "field": "versioning_scheme",
      "url": "https://developer.spreedly.com/changelog/update-airwallex-latest-api-version",
      "excerpt": "Client APIs use a date-based versioning system, and new versions are only released when there are backward-incompatible changes.",
      "confidence": "high"
    },
    {
      "field": "sdk_packages",
      "url": "https://www.airwallex.com/docs/developer-tools/sdks/server-side-sdks-(beta)",
      "excerpt": "@airwallex/node-sdk is a TypeScript-first SDK designed for integrating with the Airwallex platform APIs using Node.js. npm install @airwallex/node-sdk@beta",
      "confidence": "high"
    },
    {
      "field": "mcp_url",
      "url": "https://www.airwallex.com/docs/developer-tools/ai/developer-mcp/set-up-developer-mcp",
      "excerpt": "Airwallex provides two MCP servers: Developer MCP (docs + sandbox tools) and Docs MCP (documentation only, no auth). The remote endpoint https://mcp-demo.airwallex.com/developer can be connected for complete functionality with OAuth flow against your sandbox account.",
      "confidence": "high"
    },
    {
      "field": "idempotency_supported",
      "url": "https://www.airwallex.com/docs/payouts/transfers/create-a-transfer",
      "excerpt": "The field name is request_id. It appears in examples as a UUID parameter included in transfer creation requests. The request_id serves as an idempotency mechanism.",
      "confidence": "high"
    },
    {
      "field": "error_format",
      "url": "https://www.airwallex.com/docs/developer-tools/api",
      "excerpt": "Airwallex uses standard HTTP status codes to indicate the success or failure of your API request.",
      "confidence": "medium"
    },
    {
      "field": "webhook_signing",
      "url": "https://www.airwallex.com/docs/developer-tools/webhooks/listen-for-webhook-events",
      "excerpt": "Airwallex computes an HMAC with the SHA-256 hash function, using the notification URL's secret key as the key and a concatenated string (x-timestamp + JSON payload) as the message.",
      "confidence": "high"
    },
    {
      "field": "webhook_events_url",
      "url": "https://www.airwallex.com/docs/developer-tools/webhooks/listen-for-webhook-events",
      "excerpt": "Review event types and payload examples by product.",
      "confidence": "medium"
    },
    {
      "field": "rate_limit_window",
      "url": "https://www.airwallex.com/docs/developer-tools/api/rate-limits",
      "excerpt": "Global: '100 requests per second'; Per endpoint: '20 per second'",
      "confidence": "high"
    },
    {
      "field": "requires_verification",
      "url": "https://www.airwallex.com/docs/connected-accounts/onboarding/understand-onboarding-requirements",
      "excerpt": "A connected account must complete onboarding verification before payment activation verification can begin.",
      "confidence": "high"
    },
    {
      "field": "launched_at",
      "url": "https://research.contrary.com/company/airwallex",
      "excerpt": "Airwallex was founded in 2015 by Jack Zhang and cofounders including Lucy Liu. The company was conceived out of a real business problem Mr Zhang faced when he and three fellow entrepreneurs owned a café in Melbourne.",
      "confidence": "high"
    },
    {
      "field": "notable_customers",
      "url": "https://www.airwallex.com/us/case-studies",
      "excerpt": "Case studies include McLaren Racing, Bird, Canva, Authentic Vacations, and others.",
      "confidence": "high"
    },
    {
      "field": "rate_limit_requests",
      "url": "https://www.airwallex.com/docs/developer-tools/api/rate-limits",
      "excerpt": "Production Environment: '100 requests per second' globally, '20 per second' per endpoint, '50' concurrent requests maximum",
      "confidence": "high"
    },
    {
      "field": "requires_verification",
      "url": "https://www.airwallex.com/docs/connected-accounts/onboarding/kyb-and-onboarding",
      "excerpt": "KYB (Know Your Business) checks are required for payments onboarding. Until verification is completed, the account may have a lifetime payout limit capped, and once this limit is reached, no further payouts are allowed until verification is complete.",
      "confidence": "high"
    },
    {
      "field": "data_retention_policy_url",
      "url": "https://assets.ctfassets.net/e6wv1zvbwa49/6zfth37fc8aEAq9cbN0H6P/fe47f3216aea5737e858f9056ac08f08/Airwallex_-_Global_Privacy_Policy.pdf",
      "excerpt": "AIRWALLEX GLOBAL CUSTOMER PRIVACY POLICY Last updated: 23 July 2025",
      "confidence": "medium"
    },
    {
      "field": "notable_customers",
      "url": "https://fortune.com/2025/11/03/airwallex-1-billion-annualized-revenue-fintech-payments-ramp-stripe-jack-zhang/",
      "excerpt": "As of October 2025, Airwallex served over 150K customers, including Brex, Rippling, Navan, Papaya Global, Afterpay, SHEIN, Deel, Canva, and TikTok.",
      "confidence": "high"
    }
  ],
  "fields_not_found": [
    "hipaa",
    "minimum_commitment (for Platform API/embedded product specifically)",
    "push_to_card rail",
    "DAC7 tax form support",
    "deprecation_policy_url",
    "sla_url",
    "starting_price_usd",
    "price_basis",
    "free_tier_limit",
    "ga_date",
    "error_format_schema"
  ],
  "source_confidence": "high",
  "last_verified_at": "2026-06-21T00:00:00.000Z",
  "contribute": {
    "note": "This data is crowd-editable. Suggest corrections or leave a review via these endpoints - no auth required, requests are rate-limited, and every submission is reviewed before it goes live. For a field edit, {field} is any key in this response and a citation is required.",
    "endpoints": [
      {
        "action": "review",
        "label": "Leave a review or comment",
        "method": "POST",
        "url": "https://apio.sh/api/feedback/airwallex-payouts",
        "example_body": {
          "kind": "review",
          "rating": 5,
          "body": "Your experience with this API…"
        }
      },
      {
        "action": "field_edit",
        "label": "Suggest a correction to a field (cite a source)",
        "method": "POST",
        "url": "https://apio.sh/api/suggest/airwallex-payouts/{field}",
        "example_body": {
          "value": "corrected value",
          "citations": [
            {
              "url": "https://source.example/page",
              "excerpt": "supporting quote"
            }
          ],
          "note": "what changed and why"
        }
      },
      {
        "action": "new_api",
        "label": "Suggest a new API to add (only name is required - send as much as you can cite)",
        "method": "POST",
        "url": "https://apio.sh/api/suggest/api",
        "example_body": {
          "value": {
            "name": "Acme Email API",
            "website_url": "https://acme.example",
            "vendor_name": "Acme",
            "categories": [
              "email"
            ],
            "pricing_model": "usage_based",
            "has_published_pricing": true,
            "free_tier_available": true,
            "price_points": [
              {
                "plan": "Pay as you go",
                "item": "1,000 emails",
                "amount_usd": 1,
                "per": "1,000 emails",
                "source_url": "https://acme.example/pricing"
              }
            ],
            "soc2": "type_2",
            "docs_url": "https://docs.acme.example"
          },
          "citations": [
            {
              "url": "https://acme.example/pricing",
              "excerpt": "$1 per 1,000 emails"
            }
          ]
        },
        "value_schema": [
          {
            "field": "name",
            "type": "string",
            "label": "Product name (the only required field)"
          },
          {
            "field": "website_url",
            "type": "string",
            "label": "Marketing website URL"
          },
          {
            "field": "vendor_name",
            "type": "string",
            "label": "Company/vendor name behind the product"
          },
          {
            "field": "vendor_description",
            "type": "string",
            "label": "One-line description, quoted from the vendor"
          },
          {
            "field": "categories",
            "type": "string[]",
            "label": "Category/leaf slugs it belongs to, e.g. [\"email\",\"sms\"]"
          },
          {
            "field": "primary_use_cases",
            "type": "string[]",
            "label": "What it's used for"
          },
          {
            "field": "supported_actions",
            "type": "string[]",
            "label": "Concrete API actions/capabilities"
          },
          {
            "field": "supported_regions",
            "type": "string[]",
            "label": "Countries/regions/data-residency"
          },
          {
            "field": "supported_languages",
            "type": "string[]",
            "label": "Human/spoken languages supported"
          },
          {
            "field": "input_types",
            "type": "string[]",
            "label": "Accepted input types/formats"
          },
          {
            "field": "output_types",
            "type": "string[]",
            "label": "Produced output types/formats"
          },
          {
            "field": "webhooks_supported",
            "type": "bool",
            "label": "Supports webhooks?"
          },
          {
            "field": "sandbox_available",
            "type": "bool",
            "label": "Dedicated sandbox/test mode?"
          },
          {
            "field": "sdk_languages",
            "type": "string[]",
            "label": "Languages with an official SDK"
          },
          {
            "field": "mcp_server_available",
            "type": "bool",
            "label": "Official MCP server?"
          },
          {
            "field": "pricing_model",
            "type": "enum",
            "label": "Pricing model",
            "values": [
              "usage_based",
              "subscription",
              "seat_based",
              "hybrid",
              "contact_sales"
            ]
          },
          {
            "field": "has_published_pricing",
            "type": "bool",
            "label": "Concrete prices published publicly?"
          },
          {
            "field": "free_tier_available",
            "type": "bool",
            "label": "Recurring/perpetual free tier (not a trial)?"
          },
          {
            "field": "free_tier_details",
            "type": "string",
            "label": "What the free tier includes"
          },
          {
            "field": "minimum_commitment",
            "type": "string",
            "label": "Any stated minimum spend/commitment"
          },
          {
            "field": "self_serve_signup",
            "type": "bool",
            "label": "Get an API key without talking to sales?"
          },
          {
            "field": "requires_sales_call",
            "type": "bool",
            "label": "Does going live require sales?"
          },
          {
            "field": "enterprise_plan_available",
            "type": "bool",
            "label": "Named enterprise tier?"
          },
          {
            "field": "starting_price_usd",
            "type": "number",
            "label": "Lowest published paid entry price (USD number)"
          },
          {
            "field": "price_basis",
            "type": "string",
            "label": "Unit the starting price is per, e.g. '1,000 emails'"
          },
          {
            "field": "free_tier_limit",
            "type": "string",
            "label": "Free-tier ceiling in literal terms"
          },
          {
            "field": "price_points",
            "type": "object[]",
            "label": "Structured prices: [{plan,item,amount_usd,amount_percent,per,source_url}]"
          },
          {
            "field": "soc2",
            "type": "enum",
            "label": "SOC 2 status",
            "values": [
              "type_2",
              "type_1",
              "in_progress",
              "none",
              "unknown"
            ]
          },
          {
            "field": "hipaa",
            "type": "bool",
            "label": "HIPAA (e.g. BAA available)?"
          },
          {
            "field": "gdpr",
            "type": "bool",
            "label": "GDPR compliance stated?"
          },
          {
            "field": "iso_27001",
            "type": "bool",
            "label": "ISO 27001 certified?"
          },
          {
            "field": "pci_dss",
            "type": "bool",
            "label": "PCI DSS compliant?"
          },
          {
            "field": "sla_published",
            "type": "bool",
            "label": "Published SLA / uptime commitment?"
          },
          {
            "field": "documented_rate_limits",
            "type": "string",
            "label": "Documented rate limits, quoted"
          },
          {
            "field": "known_restrictions",
            "type": "string[]",
            "label": "Notable documented restrictions/limits"
          },
          {
            "field": "auth_methods",
            "type": "string[]",
            "label": "Auth methods",
            "values": [
              "api_key",
              "oauth2",
              "jwt",
              "basic",
              "hmac_signature",
              "mtls",
              "session"
            ]
          },
          {
            "field": "api_style",
            "type": "enum",
            "label": "Primary API style",
            "values": [
              "rest",
              "graphql",
              "grpc",
              "soap",
              "websocket"
            ]
          },
          {
            "field": "base_url",
            "type": "string",
            "label": "API root/base URL"
          },
          {
            "field": "api_version",
            "type": "string",
            "label": "Current API version string"
          },
          {
            "field": "quickstart_url",
            "type": "string",
            "label": "Quickstart / hello-world URL"
          },
          {
            "field": "docs_url",
            "type": "string",
            "label": "Developer docs URL"
          },
          {
            "field": "api_reference_url",
            "type": "string",
            "label": "API reference URL"
          },
          {
            "field": "openapi_spec_url",
            "type": "string",
            "label": "OpenAPI spec URL"
          },
          {
            "field": "changelog_url",
            "type": "string",
            "label": "Changelog URL"
          },
          {
            "field": "status_page_url",
            "type": "string",
            "label": "Status page URL"
          },
          {
            "field": "notable_customers",
            "type": "string[]",
            "label": "Named public customers"
          },
          {
            "field": "launched_at",
            "type": "string",
            "label": "Launch date (ISO date or year)"
          }
        ]
      },
      {
        "action": "token",
        "label": "Optional - raise your rate limit",
        "method": "GET",
        "url": "https://apio.sh/api/feedback/token"
      }
    ]
  }
}