{
  "name": "Worldpay",
  "slug": "worldpay",
  "website_url": "https://www.worldpay.com",
  "vendor_description": "\"With Worldpay, businesses of all sizes can boost revenue, innovate at pace and create payment experiences their customers love.\"",
  "categories": [
    "payouts",
    "card-acquiring"
  ],
  "summary": "Worldpay is a global card acquiring and payments platform serving businesses of all sizes, covering online checkout, in-store, marketplace, subscription billing, and cross-border payouts across 174 countries with over 60 acquiring licenses. Pricing is negotiated through sales and there is no self-serve signup. The REST API ships SDKs for Android, iOS, React Native, Java, PHP, .NET, and Python, supports webhooks and idempotency, and includes an MCP server. Worldpay holds PCI DSS Level 1 certification and ISO 27001:2013 accreditation; customers include Zalando, Sephora, and AutoZone.",
  "capabilities": {
    "supported_actions": [
      "card_payments",
      "hosted_checkout",
      "hosted_payment_pages",
      "tokenization",
      "network_tokenization",
      "3ds_authentication",
      "sca_exemptions",
      "recurring_payments",
      "merchant_initiated_transactions",
      "card_payouts",
      "account_payouts",
      "account_transfers",
      "money_transfers",
      "split_payments",
      "refunds",
      "cancellations",
      "settlement",
      "fraud_screening",
      "dispute_management",
      "alternative_payment_methods",
      "apple_pay",
      "google_pay",
      "foreign_exchange",
      "card_verifications",
      "card_bin_data_lookup",
      "account_updater",
      "webhooks",
      "payment_queries",
      "moto_payments",
      "payment_links",
      "sessions_api",
      "statements",
      "balances",
      "beneficiary_account_verification",
      "agentic_commerce_mcp"
    ],
    "supported_regions": [
      "249 countries and territories via ISO country codes",
      "60+ acquiring licenses globally",
      "174 countries for transaction acceptance",
      "domestic acquiring in Australia, New Zealand, Singapore, Hong Kong, Japan, Malaysia, India, South Korea, Thailand, Colombia, and others"
    ],
    "supported_languages": [],
    "input_types": [
      "Visa",
      "Mastercard",
      "American Express",
      "Discover",
      "Diners Club",
      "JCB",
      "Maestro",
      "Cartes Bancaires",
      "ELO",
      "eftpos Australia",
      "Visa Electron (UK only)",
      "Mastercard Debit",
      "Visa Debit",
      "Apple Pay",
      "Google Pay",
      "iDEAL",
      "Bancontact",
      "SEPA Direct Debit",
      "Przelewy24",
      "BLIK",
      "Bizum",
      "Swish",
      "Trustly",
      "MyBank",
      "BANCOMAT Pay",
      "Multibanco",
      "Euteller",
      "Open Banking",
      "Alipay",
      "Alipay Hong Kong",
      "Alipay+",
      "WeChat Pay",
      "UnionPay",
      "Konbini",
      "ACH",
      "EFT",
      "Pix",
      "SafetyPay",
      "PayPal",
      "Klarna",
      "PaysafeCard"
    ],
    "output_types": [
      "JSON API responses",
      "webhook events",
      "hosted checkout page",
      "payment links",
      "settlement reports",
      "statements",
      "card tokens",
      "network tokens",
      "OpenAPI 3.0 schemas",
      "Postman collections"
    ],
    "webhooks_supported": true,
    "sandbox_available": true,
    "sdk_languages": [
      "Android (Kotlin)",
      "iOS (Swift)",
      "React Native",
      "Java",
      "PHP",
      ".NET (C#)",
      "Python"
    ],
    "mcp_server_available": true
  },
  "integration": {
    "api_style": "rest",
    "base_url": "https://access.worldpay.com",
    "api_version": "2024-06-01",
    "versioning_scheme": "header",
    "stability": "ga",
    "deprecation_policy_url": "https://docs.worldpay.com/access/products/reference/api-principles",
    "auth_methods": [
      "basic"
    ],
    "auth_docs_url": "https://docs.worldpay.com/access/products/reference/api-principles",
    "idempotency_supported": true,
    "error_format": "vendor-specific",
    "webhook_signing": "hmac_sha256",
    "webhook_events_url": "https://docs.worldpay.com/access/products/events/openapi",
    "rate_limit_requests": null,
    "rate_limit_window": null,
    "sdk_packages": [
      {
        "package": "access-checkout-android",
        "language": "Android (Kotlin)",
        "official": true,
        "repo_url": "https://github.com/Worldpay/access-checkout-android"
      },
      {
        "package": "access-checkout-ios",
        "language": "iOS (Swift)",
        "official": true,
        "repo_url": "https://github.com/Worldpay/access-checkout-ios"
      },
      {
        "package": "access-checkout-react-native",
        "language": "React Native",
        "official": true,
        "repo_url": "https://github.com/Worldpay/access-checkout-react-native"
      },
      {
        "package": "cnp-sdk-for-java",
        "language": "Java",
        "official": true,
        "repo_url": "https://github.com/Worldpay/cnp-sdk-for-java"
      },
      {
        "package": "cnp-sdk-for-php",
        "language": "PHP",
        "official": true,
        "repo_url": "https://github.com/Worldpay/cnp-sdk-for-php"
      },
      {
        "package": "cnp-sdk-for-dotnet",
        "language": ".NET (C#)",
        "official": true,
        "repo_url": "https://github.com/Worldpay/cnp-sdk-for-dotnet"
      },
      {
        "package": "vantiv-sdk-for-python",
        "language": "Python",
        "official": true,
        "repo_url": "https://github.com/Worldpay/vantiv-sdk-for-python"
      }
    ],
    "mcp_url": "https://github.com/Worldpay/worldpay-mcp",
    "quickstart_url": "https://docs.worldpay.com/access/products/card-payments/v5/get-started"
  },
  "pricing": {
    "pricing_model": "contact_sales",
    "has_published_pricing": true,
    "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": true,
    "price_points": [
      {
        "plan": "Pay As You Go",
        "item": "Visa and Mastercard consumer card transaction (UK ecommerce)",
        "amount_usd": null,
        "amount_percent": "1.3000",
        "per": "transaction",
        "currency": "USD",
        "source_url": "https://www.worldpay.com/en-GB/products/worldpay-ecommerce"
      },
      {
        "plan": "Pay As You Go",
        "item": "Commercial card and Amex transaction (UK ecommerce)",
        "amount_usd": null,
        "amount_percent": "2.9000",
        "per": "transaction",
        "currency": "USD",
        "source_url": "https://www.worldpay.com/en-GB/products/worldpay-ecommerce"
      },
      {
        "plan": "Pay As You Go",
        "item": "Visa and Mastercard debit and credit card (UK Payment Links+)",
        "amount_usd": null,
        "amount_percent": "1.3000",
        "per": "transaction",
        "currency": "USD",
        "source_url": "https://www.worldpay.com/en-GB/products/payment-links"
      },
      {
        "plan": "Pay As You Go",
        "item": "Amex and corporate card (UK Payment Links+)",
        "amount_usd": null,
        "amount_percent": "2.8000",
        "per": "transaction",
        "currency": "USD",
        "source_url": "https://www.worldpay.com/en-GB/products/payment-links"
      },
      {
        "plan": "Simplicity",
        "item": "Visa and Mastercard transaction (UK in-person card machine)",
        "amount_usd": null,
        "amount_percent": "1.5000",
        "per": "transaction",
        "currency": "USD",
        "source_url": "https://www.worldpay.com/en-GB/products/countertop-card-machines"
      },
      {
        "plan": "Simplicity",
        "item": "Terminal hire — countertop card machine (UK, 18-month contract; regular price)",
        "amount_usd": null,
        "amount_percent": null,
        "per": "month (GBP £17.50/mo)",
        "currency": "USD",
        "source_url": "https://www.worldpay.com/en-GB/products/countertop-card-machines"
      },
      {
        "plan": "Simplicity",
        "item": "Terminal hire — mobile card machine (UK, 18-month contract; regular price)",
        "amount_usd": null,
        "amount_percent": null,
        "per": "month (GBP £22.50/mo)",
        "currency": "USD",
        "source_url": "https://www.worldpay.com/en-GB/products/mobile-card-machines"
      }
    ]
  },
  "compliance": {
    "soc2": null,
    "hipaa": null,
    "gdpr": true,
    "iso_27001": true,
    "pci_dss": true,
    "sla_published": false,
    "sla_url": "https://status.access.worldpay.com/history",
    "data_retention_policy_url": "https://privacy.worldpay.com/policies/en/?name=retention",
    "documented_rate_limits": null,
    "known_restrictions": [
      "PCI DSS Level 1 service provider (highest level); Worldpay holds Level 1 PCI DSS compliance across AU, NZ, and US jurisdictions",
      "ISO 27001:2013 certified, aligned to NIST and CIS frameworks",
      "API credentials obtained via Worldpay Implementation Manager - no self-serve key issuance",
      "Webhooks require HTTPS with SHA-256+ certificate chain; SHA-1 support ended March 2026",
      "Card Payouts restricted to Maestro, Mastercard, and Visa only",
      "Exemptions (3DS bypass) available only for Mastercard and Visa",
      "Currency/country access varies by merchant account and requires consultation with Implementation Manager",
      "Marketplace sub-merchant payments not supported across all card networks per the supported payment methods matrix",
      "Bulgaria (BGN) authorizations decline from January 1, 2026 due to EUR adoption",
      "Published per-transaction rates (1.3%+20p, 2.9%+20p) apply to UK SMB ecommerce segment only; enterprise and global API pricing is quote-only"
    ]
  },
  "developer": {
    "docs_url": "https://docs.worldpay.com/",
    "api_reference_url": null,
    "openapi_spec_url": null,
    "postman_collection_url": null,
    "changelog_url": null,
    "status_page_url": "https://status.worldpay.com",
    "llms_txt_url": null,
    "markdown_docs_url": null,
    "rendering": "static"
  },
  "adoption": {
    "launched_at": "1997-01-01",
    "ga_date": null,
    "github_stars": null,
    "github_stars_at": null,
    "notable_customers": [
      "Asda",
      "Betfred",
      "Zalando",
      "AutoZone",
      "Sephora"
    ]
  },
  "scores": {
    "agent_friendliness": 50,
    "pricing_transparency": 45,
    "setup_speed": 40,
    "docs_quality": 15,
    "procurement_friction": 20,
    "trust_readiness": 40,
    "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 want to try it free before paying",
      "You have strict compliance requirements"
    ]
  },
  "sources": [
    {
      "field": "vendor_description",
      "url": "https://www.worldpay.com/en",
      "excerpt": "With Worldpay, businesses of all sizes can boost revenue, innovate at pace and create payment experiences their customers love.",
      "confidence": "high"
    },
    {
      "field": "categories",
      "url": "https://www.worldpay.com/en-GB/products/payouts",
      "excerpt": "Send funds quickly, securely and in the way your beneficiaries prefer – anywhere in the world.",
      "confidence": "high"
    },
    {
      "field": "primary_use_cases",
      "url": "https://docs.worldpay.com/access/",
      "excerpt": "Payments: Card payments (via HPP, orchestrated, or modular APIs), wallet payments",
      "confidence": "high"
    },
    {
      "field": "supported_actions",
      "url": "https://docs.worldpay.com/access/products/card-payments",
      "excerpt": "Merchant-Initiated Transactions (MITs): Take repeat card payments that are initiated by you, the merchant",
      "confidence": "high"
    },
    {
      "field": "input_types",
      "url": "https://docs.worldpay.com/access/products/apms",
      "excerpt": "APMs are payment options that are not cash or credit/debit cards issued by a major bank",
      "confidence": "high"
    },
    {
      "field": "supported_regions",
      "url": "https://www.worldpay.com/en/insights/articles/build-ai-powered-payments-faster-mcp",
      "excerpt": "Access to 60+ acquiring licenses",
      "confidence": "high"
    },
    {
      "field": "has_published_pricing",
      "url": "https://www.worldpay.com/en-GB/products/payment-links",
      "excerpt": "1.3%+20p for each Visa and Mastercard debit and credit card. 2.8%+20p for American Express and corporate card",
      "confidence": "high"
    },
    {
      "field": "pricing_model",
      "url": "https://www.worldpay.com/en-GB/contact-us-enterprise",
      "excerpt": "Enterprise customers directed to contact sales team for tailored pricing",
      "confidence": "high"
    },
    {
      "field": "pci_dss",
      "url": "https://platforms.worldpay.com/embedded-payments/safer-payments/",
      "excerpt": "Worldpay's SaferPayments solutions keep merchants current with PCI DSS 4.0 guidelines and beyond.",
      "confidence": "high"
    },
    {
      "field": "gdpr",
      "url": "https://privacy.worldpay.com/policies/en/?name=data-processing-agreement",
      "excerpt": "Worldpay's compliance program is based on the European Union General Data Protection Regulation (GDPR) and establishes a framework within which local privacy and data protection laws are respected",
      "confidence": "high"
    },
    {
      "field": "webhooks_supported",
      "url": "https://docs.worldpay.com/access/products/events",
      "excerpt": "Worldpay webhooks deliver real-time status updates for requests. The system provides automatic updates when there is a status change with your transaction requests.",
      "confidence": "high"
    },
    {
      "field": "mcp_server_available",
      "url": "https://github.com/Worldpay/worldpay-mcp",
      "excerpt": "The Worldpay Model Context Protocol (MCP) Server integrates Worldpay's payment processing capabilities with AI tools, enabling automated payment operations through a standardized protocol.",
      "confidence": "high"
    },
    {
      "field": "sla_published",
      "url": "https://status.access.worldpay.com/history",
      "excerpt": null,
      "confidence": "high"
    },
    {
      "field": "known_restrictions",
      "url": "https://docs.worldpay.com/access/products/reference/supported-payment-methods",
      "excerpt": "Card Payouts are restricted to Maestro, Mastercard, and Visa only",
      "confidence": "high"
    },
    {
      "field": "auth_methods",
      "url": "https://docs.worldpay.com/access/products/reference/api-principles",
      "excerpt": "We use a single set of basic auth credentials for all our Access APIs",
      "confidence": "high"
    },
    {
      "field": "base_url",
      "url": "https://docs.worldpay.com/access/products/reference/api-principles",
      "excerpt": "Try (test): https://try.access.worldpay.com and Live: https://access.worldpay.com",
      "confidence": "high"
    },
    {
      "field": "versioning_scheme",
      "url": "https://docs.worldpay.com/access/products/reference/api-principles",
      "excerpt": "version header WP-Api-Version with a date e.g. 2024-06-01 indicating the initial release or latest breaking version",
      "confidence": "high"
    },
    {
      "field": "sdk_packages",
      "url": "https://github.com/Worldpay/access-checkout-android",
      "excerpt": null,
      "confidence": "high"
    },
    {
      "field": "mcp_url",
      "url": "https://github.com/Worldpay/worldpay-mcp",
      "excerpt": "The Worldpay Model Context Protocol (MCP) Server provides tools for payment processing integration, including capabilities for taking payments, managing transactions, generating payment links, and querying payment data",
      "confidence": "high"
    },
    {
      "field": "quickstart_url",
      "url": "https://docs.worldpay.com/access/products/card-payments/v5/get-started",
      "excerpt": "Get started with our Payments API — set Authorization header with base64-encoded Basic Auth credentials",
      "confidence": "high"
    },
    {
      "field": "idempotency_supported",
      "url": "https://docs.worldpay.com/apis/wpg/idempotency",
      "excerpt": null,
      "confidence": "medium"
    },
    {
      "field": "webhook_signing",
      "url": "https://docs.worldpay.com/access/products/events/signature",
      "excerpt": "Event-Signature:{keyId}/{hashFunction}/{signature}. The cryptographic hash function used to create the HMAC. Currently supported: SHA256",
      "confidence": "high"
    },
    {
      "field": "requires_verification",
      "url": "https://onemoneyway.com/en/blog/worldpay-sign-up/",
      "excerpt": null,
      "confidence": "high"
    },
    {
      "field": "data_retention_policy_url",
      "url": "https://privacy.worldpay.com/policies/en/?name=retention",
      "excerpt": null,
      "confidence": "high"
    },
    {
      "field": "launched_at",
      "url": "https://en.wikipedia.org/wiki/Worldpay_Group",
      "excerpt": "WorldPay started as an online multi-currency payment system in 1997, founded by Nick Ogden",
      "confidence": "high"
    },
    {
      "field": "categories",
      "url": "https://www.worldpay.com/en/fraudsight",
      "excerpt": "FraudSight is Worldpay's flagship fraud prevention solution built to protect your business across all channels—online, in-store, and mobile.",
      "confidence": "high"
    },
    {
      "field": "primary_use_cases",
      "url": "https://www.worldpay.com/en",
      "excerpt": "Accept: Deliver simplified, high-converting checkouts across all channels with global payment options",
      "confidence": "high"
    },
    {
      "field": "supported_actions",
      "url": "https://docs.worldpay.com/access/products/events",
      "excerpt": "Worldpay webhooks deliver real-time status updates for requests. The system provides automatic updates when there is a status change with your transaction requests.",
      "confidence": "high"
    },
    {
      "field": "input_types",
      "url": "https://docs.worldpay.com/access/products/card-payments",
      "excerpt": "American Express, Cartes Bancaires, Discover, Diners, EFTPOS, ELO, JCB, Maestro, Mastercard (standard and Debit), Visa (standard, Debit, and Electron for UK only)",
      "confidence": "high"
    },
    {
      "field": "supported_regions",
      "url": "https://docs.worldpay.com/access/products/reference/supported-countries-currencies",
      "excerpt": "Worldpay supports 249 countries and territories via ISO country codes, ranging from Afghanistan (AF) to Zimbabwe (ZW).",
      "confidence": "high"
    },
    {
      "field": "has_published_pricing",
      "url": "https://www.worldpay.com/en-GB/products/worldpay-ecommerce",
      "excerpt": "Visa and Mastercard consumer cards: 1.3% +20p. Commercial cards and American Express: 2.9% +20p",
      "confidence": "high"
    },
    {
      "field": "pricing_model",
      "url": "https://www.worldpay.com/en-GB/products/worldpay-ecommerce",
      "excerpt": "Visa and Mastercard consumer cards: 1.3% +20p. Other charges may apply. All quotes are subject to contract.",
      "confidence": "high"
    },
    {
      "field": "pci_dss",
      "url": "https://platforms.worldpay.com/en/useful-documents/",
      "excerpt": "PCI DSS Certificate Level 1 [AU], PCI DSS Certificate Level 1 [NZ], PCI DSS Certificate Level 1 [US]",
      "confidence": "high"
    },
    {
      "field": "iso_27001",
      "url": "https://platforms.worldpay.com/en/wp-content/uploads/sites/2/2025/06/Worldpay-Data-Processing-Addendum.pdf",
      "excerpt": "Worldpay's ISO 27001:2013 certifications are aligned to the NIST and CIS frameworks, and are designed to protect the security, confidentiality and integrity of Merchant Data, including Merchant Personal Data.",
      "confidence": "high"
    },
    {
      "field": "soc2",
      "url": "https://privacy.worldpay.com/policies/en/?name=worldpay-technical-and-organizational-measures",
      "excerpt": null,
      "confidence": "high"
    },
    {
      "field": "sandbox_available",
      "url": "https://docs.worldpay.com/access/products/card-payments/v5/get-started",
      "excerpt": "The documentation references https://try.access.worldpay.com/ as the base endpoint for testing and discovery requests.",
      "confidence": "high"
    },
    {
      "field": "self_serve_signup",
      "url": "https://docs.worldpay.com/access/products/card-payments/v5/get-started",
      "excerpt": "Credentials are base64-encoded Basic Auth credentials obtained from your Worldpay Implementation Manager.",
      "confidence": "high"
    },
    {
      "field": "known_restrictions",
      "url": "https://platforms.worldpay.com/en/useful-documents/",
      "excerpt": "PCI DSS Certificate Level 1 [AU], PCI DSS Certificate Level 1 [NZ], PCI DSS Certificate Level 1 [US]",
      "confidence": "high"
    },
    {
      "field": "known_restrictions",
      "url": "https://www.worldpay.com/en-GB/products/worldpay-ecommerce",
      "excerpt": "1.3% +20p on Visa and Mastercard consumer cards (UK SMB ecommerce Pay As You Go plan)",
      "confidence": "high"
    },
    {
      "field": "auth_methods",
      "url": "https://docs.worldpay.com/access/products/card-payments/v5/get-started",
      "excerpt": "The Authorization header is used for authentication and identification of our merchants within Access Worldpay. You must use the Authorization header for any request you send to our Payments API.",
      "confidence": "high"
    },
    {
      "field": "api_version",
      "url": "https://docs.worldpay.com/access/products/payments/changelog",
      "excerpt": "Use the value 2024-06-01 in the header parameter WP-Api-Version. This version was released as an Initial release and remains the only listed breaking version.",
      "confidence": "high"
    },
    {
      "field": "deprecation_policy_url",
      "url": "https://docs.worldpay.com/access/products/reference/api-principles",
      "excerpt": "For changes that alter the existing behavior, resource names, objects or key:values, a new API version is required",
      "confidence": "medium"
    },
    {
      "field": "sdk_packages",
      "url": "https://github.com/Worldpay/cnp-sdk-for-java",
      "excerpt": "Java SDK to ease XML integrations with the Vantiv eCommerce platform",
      "confidence": "high"
    },
    {
      "field": "mcp_url",
      "url": "https://www.worldpay.com/en/insights/articles/build-ai-powered-payments-faster-mcp",
      "excerpt": "an open-source, AI-ready server for payments that gives teams a production-ready place to build, test and scale AI-powered payment integrations",
      "confidence": "high"
    },
    {
      "field": "idempotency_supported",
      "url": "https://docs.worldpay.com/access/products/account-payouts/openapi/single-payout",
      "excerpt": "Idempotency-Key parameter, a unique key to identify requests and prevent duplicate processing",
      "confidence": "medium"
    },
    {
      "field": "error_format",
      "url": "https://docs.worldpay.com/access/products/reference/worldpay-error-responses",
      "excerpt": "errorName: A machine and human readable error type for clarity and semantic understanding of the error. message: A human readable message giving a corrective action for the error.",
      "confidence": "high"
    },
    {
      "field": "webhook_events_url",
      "url": "https://docs.worldpay.com/access/products/events/openapi",
      "excerpt": null,
      "confidence": "high"
    },
    {
      "field": "requires_verification",
      "url": "https://onemoneyway.com/en/blog/worldpay-due-diligence/",
      "excerpt": "Worldpay conducts Know Your Customer (KYC) and Know Your Business (KYB) checks as part of its merchant onboarding process",
      "confidence": "high"
    },
    {
      "field": "notable_customers",
      "url": "https://www.worldpay.com/en/insights/client-stories",
      "excerpt": "Client stories — Asda, Betfred, and other named merchants featured as Worldpay case studies",
      "confidence": "medium"
    },
    {
      "field": "sla_url",
      "url": "https://status.access.worldpay.com/history",
      "excerpt": null,
      "confidence": "medium"
    }
  ],
  "fields_not_found": [
    "soc2",
    "hipaa",
    "documented_rate_limits",
    "sla_published",
    "minimum_commitment",
    "free_tier_details",
    "rate_limit_requests",
    "rate_limit_window",
    "starting_price_usd",
    "price_basis",
    "ga_date",
    "free_tier_limit"
  ],
  "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/worldpay",
        "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/worldpay/{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"
      }
    ]
  }
}