{
  "name": "Adyen Issuing",
  "slug": "adyen-issuing",
  "website_url": "https://www.adyen.com/issuing",
  "vendor_description": "\"Get everything you need to create and manage your card program with our financial technology platform.\"",
  "categories": [
    "card-issuing"
  ],
  "summary": "Adyen Issuing is a card program management API for platforms and marketplaces that need to embed branded virtual or physical cards into their products, covering use cases from supplier payments to corporate expense management. It is available in the US, UK, and European Economic Area, where Adyen operates under its own banking license and acts as BIN sponsor, removing the need for a third-party sponsor bank. Pricing is custom and requires a sales engagement; no self-serve sandbox access is available. The REST API ships with SDKs in seven languages, supports webhooks and idempotency, and holds SOC 2 Type 2, ISO 27001, and PCI DSS certifications.",
  "capabilities": {
    "supported_actions": [
      "issue_virtual_card",
      "issue_physical_card",
      "card_lifecycle_management",
      "spend_controls",
      "transaction_rules",
      "relayed_authorization",
      "jit_funding",
      "push_provisioning",
      "tokenization",
      "network_tokens",
      "3ds",
      "authorization_stream",
      "real_time_webhooks",
      "dispute_management",
      "pin_management",
      "kyc_kyb",
      "balance_account_management",
      "program_management",
      "ledger_accounts",
      "sweep_payouts",
      "external_bank_transfers",
      "sca_device_registration"
    ],
    "supported_regions": [
      "European Economic Area",
      "United Kingdom",
      "United States"
    ],
    "supported_languages": [],
    "input_types": [
      "Visa",
      "Mastercard",
      "virtual",
      "physical",
      "debit",
      "prepaid"
    ],
    "output_types": [
      "JSON",
      "webhook events",
      "card tokens",
      "network tokens",
      "authorization events",
      "transaction data",
      "balance reports",
      "payment instrument reports"
    ],
    "webhooks_supported": true,
    "sandbox_available": true,
    "sdk_languages": [
      "Java",
      "Node.js",
      "Python",
      "PHP",
      ".NET",
      "Go",
      "Ruby"
    ],
    "mcp_server_available": false
  },
  "integration": {
    "api_style": "rest",
    "base_url": "https://balanceplatform-api-live.adyen.com/bcl/v2",
    "api_version": "v2",
    "versioning_scheme": "url",
    "stability": "ga",
    "deprecation_policy_url": "https://docs.adyen.com/development-resources/versioning",
    "auth_methods": [
      "api_key",
      "basic"
    ],
    "auth_docs_url": "https://docs.adyen.com/development-resources/api-authentication",
    "idempotency_supported": true,
    "error_format": "vendor-specific",
    "webhook_signing": "hmac_sha256",
    "webhook_events_url": "https://docs.adyen.com/issuing/webhook-types",
    "rate_limit_requests": null,
    "rate_limit_window": null,
    "sdk_packages": [
      {
        "package": "com.adyen:adyen-java-api-library",
        "language": "Java",
        "official": true,
        "repo_url": "https://github.com/Adyen/adyen-java-api-library"
      },
      {
        "package": "@adyen/api-library",
        "language": "Node.js",
        "official": true,
        "repo_url": "https://github.com/Adyen/adyen-node-api-library"
      },
      {
        "package": "Adyen",
        "language": "Python",
        "official": true,
        "repo_url": "https://github.com/Adyen/adyen-python-api-library"
      },
      {
        "package": "adyen/php-api-library",
        "language": "PHP",
        "official": true,
        "repo_url": "https://github.com/Adyen/adyen-php-api-library"
      },
      {
        "package": "Adyen",
        "language": ".NET",
        "official": true,
        "repo_url": "https://github.com/Adyen/adyen-dotnet-api-library"
      },
      {
        "package": "github.com/adyen/adyen-go-api-library/v8",
        "language": "Go",
        "official": true,
        "repo_url": "https://github.com/Adyen/adyen-go-api-library"
      },
      {
        "package": "adyen-ruby-api-library",
        "language": "Ruby",
        "official": true,
        "repo_url": "https://github.com/Adyen/adyen-ruby-api-library"
      }
    ],
    "mcp_url": "https://github.com/Adyen/adyen-mcp",
    "quickstart_url": "https://docs.adyen.com/issuing/get-started"
  },
  "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": false,
    "requires_sales_call": true,
    "requires_verification": true,
    "enterprise_plan_available": null,
    "price_points": []
  },
  "compliance": {
    "soc2": "type_2",
    "hipaa": null,
    "gdpr": true,
    "iso_27001": true,
    "pci_dss": true,
    "sla_published": true,
    "sla_url": "https://www.adyen.com/legal/terms-and-conditions",
    "data_retention_policy_url": "https://www.adyen.com/privacy-policy",
    "documented_rate_limits": "Live environments: 700 requests per 5 seconds; Test environments: 200 requests per 5 seconds; Failed requests: 5 failures per 10 seconds.",
    "known_restrictions": [
      "Adyen is a regulated credit institution (banking license from De Nederlandsche Bank / Dutch Central Bank) and acts as its own BIN sponsor in the EEA and UK - customers do not need to bring their own sponsor bank in those regions",
      "In UAE, Adyen MEA FZ-LLC operates under a BIN-sponsorship arrangement (not a direct banking license)",
      "Cards must be associated with a Visa or Mastercard pre-approved use case called a scheme program; Adyen handles the scheme program by default",
      "Physical card visual designs require Visa or Mastercard approval before live deployment",
      "Currently available for businesses in the US, UK, and Europe only",
      "Getting started requires contacting Adyen sales; test credentials are issued only after an initial sales/onboarding conversation - no self-serve sandbox access",
      "PCI DSS Level 1 Service Provider (v4.0)",
      "Adyen MCP server does not currently support the Balance Platform / Issuing API (only Checkout and Management APIs are covered)"
    ]
  },
  "developer": {
    "docs_url": "https://docs.adyen.com/",
    "api_reference_url": null,
    "openapi_spec_url": null,
    "postman_collection_url": null,
    "changelog_url": null,
    "status_page_url": "https://status.adyen.com",
    "llms_txt_url": "https://www.adyen.com/llms.txt",
    "markdown_docs_url": null,
    "rendering": "static"
  },
  "adoption": {
    "launched_at": "2019-11-13",
    "ga_date": null,
    "github_stars": null,
    "github_stars_at": null,
    "notable_customers": [
      "Glovo",
      "Spendesk"
    ]
  },
  "scores": {
    "agent_friendliness": 35,
    "pricing_transparency": 0,
    "setup_speed": 40,
    "docs_quality": 25,
    "procurement_friction": 0,
    "trust_readiness": 85,
    "best_for": [
      "AI agents and automation - an agent-ready surface (MCP / llms.txt)",
      "Teams needing broad API coverage out of the box"
    ],
    "avoid_if": [
      "You need to start building today without contacting sales",
      "You need transparent pricing up front",
      "You want to try it free before paying"
    ]
  },
  "sources": [
    {
      "field": "vendor_description",
      "url": "https://www.adyen.com/issuing",
      "excerpt": "Get everything you need to create and manage your card program with our financial technology platform.",
      "confidence": "high"
    },
    {
      "field": "input_types",
      "url": "https://docs.adyen.com/issuing",
      "excerpt": "Adyen Issuing allows you to issue fully customizable virtual and physical debit cards from Mastercard and Visa to your users.",
      "confidence": "high"
    },
    {
      "field": "supported_regions",
      "url": "https://www.adyen.com/issuing",
      "excerpt": "Currently available for businesses in the US, UK, and Europe only.",
      "confidence": "high"
    },
    {
      "field": "supported_actions",
      "url": "https://docs.adyen.com/issuing",
      "excerpt": "Receive authorization requests on your own servers so you can approve or decline any authorization",
      "confidence": "high"
    },
    {
      "field": "supported_actions",
      "url": "https://docs.adyen.com/issuing/manage-cards",
      "excerpt": "Push provisioning to digital wallets",
      "confidence": "high"
    },
    {
      "field": "mcp_server_available",
      "url": "https://docs.adyen.com/development-resources/mcp-server",
      "excerpt": "Currently, interactions with the following APIs are supported, we are working on adding more APIs and endpoints.",
      "confidence": "high"
    },
    {
      "field": "pricing_model",
      "url": "https://www.adyen.com/knowledge-hub/what-is-interchange-for-issuing.md",
      "excerpt": "Issuer fees are set by Adyen and determined by monthly card volume",
      "confidence": "high"
    },
    {
      "field": "has_published_pricing",
      "url": "https://www.adyen.com/knowledge-hub/what-is-interchange-for-issuing.md",
      "excerpt": "Scheme fees and Interchange fees are driven by variables",
      "confidence": "high"
    },
    {
      "field": "self_serve_signup",
      "url": "https://docs.adyen.com/issuing/get-started",
      "excerpt": "After you have designed your implementation, you will receive your Adyen test credentials by email.",
      "confidence": "high"
    },
    {
      "field": "pci_dss",
      "url": "https://help.adyen.com/en_US/knowledge/security/security-principles/what-are-the-adyen-security-certifications",
      "excerpt": "We are fully Payment Card Industry Data Security Standard (PCI DSS) v4.0 Level 1 compliant.",
      "confidence": "high"
    },
    {
      "field": "soc2",
      "url": "https://help.adyen.com/en_US/knowledge/security/security-principles/what-are-the-adyen-security-certifications",
      "excerpt": "We are audited annually by an external auditor to achieve a SOC 2 Type 2 certification.",
      "confidence": "high"
    },
    {
      "field": "gdpr",
      "url": "https://www.adyen.com/privacy-policy",
      "excerpt": "When transferring data to countries outside of the EEA, Adyen has implemented appropriate safeguards, with transfers to Adyen group companies protected by an intragroup agreement containing Standard Contractual Clauses.",
      "confidence": "medium"
    },
    {
      "field": "sla_published",
      "url": "https://www.adyen.com/legal/terms-and-conditions",
      "excerpt": "Adyen commits to use all commercially reasonable efforts to achieve an average minimum uptime of 99.9% (measured on a quarterly basis)",
      "confidence": "high"
    },
    {
      "field": "known_restrictions",
      "url": "https://www.adyen.com/licenses/emea",
      "excerpt": "Adyen N.V. is authorised as a credit Institution under the supervision of Dutch Central Bank (De Nederlandsche Bank)",
      "confidence": "high"
    },
    {
      "field": "known_restrictions",
      "url": "https://docs.adyen.com/issuing/create-cards",
      "excerpt": "By default, Adyen handles the scheme program for you in the background.",
      "confidence": "high"
    },
    {
      "field": "webhooks_supported",
      "url": "https://docs.adyen.com/issuing/webhook-types",
      "excerpt": "balancePlatform.transfer.created, balancePlatform.transfer.updated, balancePlatform.paymentInstrument.created, balancePlatform.dispute.created",
      "confidence": "high"
    },
    {
      "field": "input_types",
      "url": "https://docs.adyen.com/issuing",
      "excerpt": "Create fully customizable virtual and physical cards from Mastercard and Visa",
      "confidence": "high"
    },
    {
      "field": "input_types",
      "url": "https://docs.adyen.com/api-explorer/balanceplatform/2/post/paymentInstruments",
      "excerpt": "brandVariant: Examples include \"visadebit\" or \"mcprepaid\"",
      "confidence": "high"
    },
    {
      "field": "supported_regions",
      "url": "https://docs.adyen.com/issuing",
      "excerpt": "Adyen Issuing is currently supported in the European Economic Area, the United Kingdom, and the United States.",
      "confidence": "high"
    },
    {
      "field": "supported_actions",
      "url": "https://docs.adyen.com/issuing",
      "excerpt": "External bank transfer as a dedicated section; Funds transfers capabilities; Balance transfer functionality between accounts",
      "confidence": "high"
    },
    {
      "field": "mcp_server_available",
      "url": "https://docs.adyen.com/development-resources/mcp-server",
      "excerpt": "The MCP server currently supports two API families: Checkout API and Management API",
      "confidence": "high"
    },
    {
      "field": "pricing_model",
      "url": "https://www.adyen.com/pricing",
      "excerpt": "Other Adyen products, besides payment methods, are priced separately",
      "confidence": "high"
    },
    {
      "field": "has_published_pricing",
      "url": "https://www.adyen.com/pricing",
      "excerpt": "The fees outlined above are indicative; please get in touch to discuss pricing options.",
      "confidence": "high"
    },
    {
      "field": "self_serve_signup",
      "url": "https://docs.adyen.com/issuing/get-started",
      "excerpt": "fill out this form to connect with Adyen's team, who then evaluate fit based on business model, card types, and transaction volume",
      "confidence": "high"
    },
    {
      "field": "requires_sales_call",
      "url": "https://docs.adyen.com/issuing/get-started",
      "excerpt": "reach out to your Adyen contact to take your account live",
      "confidence": "high"
    },
    {
      "field": "pci_dss",
      "url": "https://help.adyen.com/en_US/knowledge/security/security-principles/what-are-the-adyen-security-certifications",
      "excerpt": "We're a PCI DSS Level 1 Service Provider, with PCI DSS compliance assessed by an independent Qualified Security Assessor (QSA) annually.",
      "confidence": "high"
    },
    {
      "field": "iso_27001",
      "url": "https://help.adyen.com/en_US/knowledge/security/security-principles/what-are-the-adyen-security-certifications",
      "excerpt": "The ISO 27001 certificate is an internationally recognized security and reliability standard.",
      "confidence": "high"
    },
    {
      "field": "gdpr",
      "url": "https://docs.adyen.com/development-resources/data-protection-api",
      "excerpt": "process Subject Erasure Requests as mandated in the General Data Protection Regulation (GDPR)",
      "confidence": "medium"
    },
    {
      "field": "documented_rate_limits",
      "url": "https://docs.adyen.com/api-explorer/legalentity/3/overview",
      "excerpt": "Live environments: 700 requests per 5 seconds; Test environments: 200 requests per 5 seconds; Failed requests: 5 failures per 10 seconds.",
      "confidence": "high"
    },
    {
      "field": "known_restrictions",
      "url": "https://www.adyen.com/licenses/emea",
      "excerpt": "Adyen MEA FZ-LLC holds a commercial license in the Dubai Internet City Free Zone of the United Arab Emirates, and currently provides its services under a BIN-sponsorship arrangement.",
      "confidence": "high"
    },
    {
      "field": "sandbox_available",
      "url": "https://docs.adyen.com/issuing/get-started",
      "excerpt": "The setup and configuration from your test Adyen Issuing account is not replicated to your live Adyen Issuing account.",
      "confidence": "high"
    },
    {
      "field": "sdk_languages",
      "url": "https://docs.adyen.com/development-resources/libraries",
      "excerpt": "Adyen provides server-side API libraries in the following programming languages: C#, Go, Java, Node.js, PHP, Python, Ruby",
      "confidence": "high"
    },
    {
      "field": "auth_methods",
      "url": "https://docs.adyen.com/development-resources/api-authentication",
      "excerpt": "Authenticate your request by sending an API key in an `x-API-key` HTTP request header.",
      "confidence": "high"
    },
    {
      "field": "auth_docs_url",
      "url": "https://docs.adyen.com/development-resources/api-authentication",
      "excerpt": "Authenticate your request by sending an API key in an `x-API-key` HTTP request header.",
      "confidence": "high"
    },
    {
      "field": "api_style",
      "url": "https://docs.adyen.com/api-explorer/balanceplatform/2/overview",
      "excerpt": "Each request to the Configuration API must be signed with an API key.",
      "confidence": "high"
    },
    {
      "field": "base_url",
      "url": "https://docs.adyen.com/development-resources/versioning",
      "excerpt": "https://balanceplatform-api-test.adyen.com/bcl/v1/balanceAccounts",
      "confidence": "high"
    },
    {
      "field": "versioning_scheme",
      "url": "https://docs.adyen.com/development-resources/versioning",
      "excerpt": "Each API URL contains a version suffix starting with either \"v\" or \"V\" character followed by a whole number to indicate the API version.",
      "confidence": "high"
    },
    {
      "field": "primary_use_cases",
      "url": "https://www.adyen.com/issuing",
      "excerpt": "Embedded Finance – Platform/marketplace branded cards for users; Supplier Payments – Virtual cards for business partner/vendor payments; Expense Management – Corporate virtual or physical cards with detailed controls and reconciliation",
      "confidence": "high"
    },
    {
      "field": "auth_methods",
      "url": "https://docs.adyen.com/development-resources/api-authentication",
      "excerpt": "Authenticate your request by sending a username and password in an `Authorization` HTTP request header.",
      "confidence": "high"
    },
    {
      "field": "api_style",
      "url": "https://www.adyen.com/issuing",
      "excerpt": "API-first design",
      "confidence": "high"
    },
    {
      "field": "base_url",
      "url": "https://docs.adyen.com/api-explorer/balanceplatform/2/overview",
      "excerpt": "Base URL (Live): https://balanceplatform-api-live.adyen.com/bcl/v2",
      "confidence": "high"
    },
    {
      "field": "api_version",
      "url": "https://docs.adyen.com/api-explorer/balanceplatform/2/overview",
      "excerpt": "Configuration v2 (latest)",
      "confidence": "high"
    },
    {
      "field": "stability",
      "url": "https://docs.adyen.com/api-explorer/balanceplatform/2/overview",
      "excerpt": "Configuration v2 - Overview",
      "confidence": "high"
    },
    {
      "field": "deprecation_policy_url",
      "url": "https://docs.adyen.com/development-resources/versioning",
      "excerpt": "You can continue to use existing API versions until you are ready to upgrade to the new version.",
      "confidence": "medium"
    },
    {
      "field": "sdk_packages",
      "url": "https://github.com/Adyen/adyen-node-api-library",
      "excerpt": "Adyen API Library for Node.js",
      "confidence": "high"
    },
    {
      "field": "mcp_url",
      "url": "https://docs.adyen.com/development-resources/mcp-server",
      "excerpt": "Adyen Model Context Protocol (MCP) server",
      "confidence": "high"
    },
    {
      "field": "quickstart_url",
      "url": "https://docs.adyen.com/issuing/get-started",
      "excerpt": "Get started section directs users to overview of steps from signup to going live",
      "confidence": "high"
    },
    {
      "field": "idempotency_supported",
      "url": "https://docs.adyen.com/development-resources/api-idempotency",
      "excerpt": "The Adyen API supports idempotency on POST requests (other request types such as GET, DELETE and PUT are idempotent by definition).",
      "confidence": "high"
    },
    {
      "field": "webhook_signing",
      "url": "https://www.adyen.com/knowledge-hub/hmac-validation-guide",
      "excerpt": "For other webhook types (Platforms, Management), the signature is calculated using the entire JSON payload and transmitted via HTTP header rather than within the payload itself.",
      "confidence": "high"
    },
    {
      "field": "webhook_events_url",
      "url": "https://docs.adyen.com/issuing/webhook-types",
      "excerpt": "balancePlatform.transfer.created, balancePlatform.transfer.updated, balancePlatform.paymentInstrument.created, balancePlatform.dispute.created",
      "confidence": "high"
    },
    {
      "field": "requires_verification",
      "url": "https://docs.adyen.com/issuing/get-started",
      "excerpt": "The setup and configuration from your test Adyen Issuing account is not replicated to your live Adyen Issuing account.",
      "confidence": "high"
    },
    {
      "field": "data_retention_policy_url",
      "url": "https://www.adyen.com/privacy-policy",
      "excerpt": "For most jurisdictions, transaction data is retained for 7 years after conclusion of the relevant transaction",
      "confidence": "high"
    },
    {
      "field": "notable_customers",
      "url": "https://www.adyen.com/press-and-media/adyen-becomes-glovos-primary-card-issuing-partner",
      "excerpt": "Adyen became Glovo's exclusive European card issuing partner, with an initial rollout of 30,000 cards to Glovo's European courier base.",
      "confidence": "high"
    },
    {
      "field": "stability",
      "url": "https://www.adyen.com/press-and-media/adyen-launches-card-issuing-offering",
      "excerpt": "Adyen unveiled its card issuing solution, enabling clients to offer virtual and physical cards",
      "confidence": "high"
    },
    {
      "field": "sdk_packages",
      "url": "https://github.com/Adyen/adyen-java-api-library",
      "excerpt": "groupId: com.adyen, artifactId: adyen-java-api-library",
      "confidence": "high"
    },
    {
      "field": "sdk_packages",
      "url": "https://github.com/Adyen/adyen-python-api-library",
      "excerpt": "Adyen API Library for Python",
      "confidence": "high"
    },
    {
      "field": "mcp_url",
      "url": "https://github.com/Adyen/adyen-mcp",
      "excerpt": "Typescript library for integrating Adyen APIs via an MCP server",
      "confidence": "high"
    },
    {
      "field": "idempotency_supported",
      "url": "https://docs.adyen.com/development-resources/api-idempotency",
      "excerpt": "The Adyen API supports idempotency, allowing you to retry a request multiple times while only performing the action once.",
      "confidence": "high"
    },
    {
      "field": "error_format",
      "url": "https://docs.adyen.com/development-resources/error-codes",
      "excerpt": "{\"status\": 422, \"errorCode\": \"101\", \"message\": \"Invalid card number\", \"errorType\": \"validation\"}",
      "confidence": "high"
    },
    {
      "field": "webhook_signing",
      "url": "https://www.adyen.com/knowledge-hub/hmac-validation-guide",
      "excerpt": "HMAC-SHA256 algorithm",
      "confidence": "high"
    },
    {
      "field": "requires_verification",
      "url": "https://docs.adyen.com/issuing/get-started",
      "excerpt": "Find out more about building a card program with Adyen by filling out this form. We'll get in touch with you...",
      "confidence": "high"
    },
    {
      "field": "sla_url",
      "url": "https://www.adyen.com/legal/terms-and-conditions",
      "excerpt": "average minimum uptime of 99.9% (measured on a quarterly basis) of the Payment Interface",
      "confidence": "high"
    },
    {
      "field": "launched_at",
      "url": "https://www.prnewswire.com/news-releases/adyen-launches-card-issuing-offering-300957066.html",
      "excerpt": "November 13, 2019 - Adyen introduced a globally-built card issuing solution enabling clients to provide virtual and physical cards",
      "confidence": "high"
    },
    {
      "field": "notable_customers",
      "url": "https://www.adyen.com/en_GB/press-and-media/spendesk-partners-with-adyen",
      "excerpt": "Spendesk plans to leverage Adyen's card issuing solution and aims to embed financial products beyond payments going forward.",
      "confidence": "high"
    }
  ],
  "fields_not_found": [
    "prepaid card type confirmed via brandVariant only (not a first-class documented card type on the issuing product page)",
    "commercial/consumer card distinction (not explicitly documented for Issuing)",
    "minimum_commitment",
    "enterprise_plan_available",
    "hipaa",
    "rate_limit_requests",
    "rate_limit_window",
    "starting_price_usd",
    "price_basis",
    "free_tier_limit",
    "ga_date"
  ],
  "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/adyen-issuing",
        "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/adyen-issuing/{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"
      }
    ]
  }
}