{
  "name": "Kaleyra WhatsApp API (Tata Communications)",
  "slug": "kaleyra",
  "website_url": "https://www.tatacommunications.com/kaleyra/cpaas/whatsapp-business-api",
  "vendor_description": "\"Send images, videos, documents, lists, and more to create interactive and engaging customer experiences\" via WhatsApp Business Platform, offered by Tata Communications (Meta Premier Partner FY26) through its Kaleyra CPaaS.",
  "categories": [
    "whatsapp"
  ],
  "summary": "Kaleyra WhatsApp API, offered by Tata Communications (a Meta Premier Partner) under its Kaleyra CPaaS platform, gives businesses access to the WhatsApp Business Platform across 190+ countries for marketing broadcasts, customer support, conversational commerce, OTP authentication, and chatbot automation. The REST API supports rich media, interactive buttons, list messages, WhatsApp Flows, catalog messages, and in-app payments in India via Razorpay and PayU. Pricing is not published and requires a sales conversation, though self-serve signup is available. The platform holds ISO 27001, HIPAA, and GDPR certifications and publishes an SLA, with customers including AirAsia, Shiprocket, and Verisure.",
  "capabilities": {
    "supported_actions": [
      "send_template_message",
      "send_session_message",
      "send_media (image, audio, video, document, sticker)",
      "interactive_buttons (reply buttons)",
      "list_messages",
      "whatsapp_flows",
      "catalog / products (single-product, multi-product, catalog messages)",
      "payments (WhatsApp Pay - India only, via Razorpay and PayU)",
      "inbound_webhooks",
      "template_management (create, edit, retrieve, delete, analytics)",
      "phone_number_registration (add, verify, OTP retry)",
      "message_status_callbacks (sent, delivered, read, failed)",
      "read_receipts",
      "reaction_messages",
      "location_sharing (send and request)",
      "contact_sharing",
      "carousel_template_messages",
      "authentication_template_messages",
      "order_details_and_status_templates",
      "coupon_code_templates",
      "limited_time_offer_templates",
      "resumable_media_upload",
      "embedded_signup (V1 and V2)"
    ],
    "supported_regions": [
      "global (190+ countries)",
      "WhatsApp Pay India only"
    ],
    "supported_languages": [
      "multilingual support stated; 40+ languages mentioned for WhatsApp messaging"
    ],
    "input_types": [
      "text",
      "template",
      "image",
      "video",
      "document",
      "audio",
      "sticker",
      "interactive buttons / lists",
      "location",
      "contacts",
      "catalog / products",
      "carousel",
      "flows",
      "authentication OTP template",
      "order details template",
      "coupon code template",
      "limited-time offer template"
    ],
    "output_types": [
      "message_status (sent/delivered/read/failed)",
      "inbound message webhook",
      "delivery receipts",
      "template approval notifications",
      "payment status webhooks",
      "opt-out status events"
    ],
    "webhooks_supported": true,
    "sandbox_available": false,
    "sdk_languages": [
      "Java"
    ],
    "mcp_server_available": false
  },
  "integration": {
    "api_style": "rest",
    "base_url": "https://api.in.kaleyra.io/v2/{SID} (IN); https://api.ap.kaleyra.io/v2/{SID} (AP/SG); https://api.eu.kaleyra.io/v2/{SID} (EU)",
    "api_version": "v2",
    "versioning_scheme": "url",
    "stability": "ga",
    "deprecation_policy_url": null,
    "auth_methods": [
      "api_key"
    ],
    "auth_docs_url": "https://developers.kaleyra.io/docs/getting-started-with-whatsapp",
    "idempotency_supported": false,
    "error_format": "vendor-specific",
    "webhook_signing": "Basic Authentication (Authorization: Basic base64(username:password)) or custom API-key header; no X-Hub-Signature-256 documented",
    "webhook_events_url": "https://developers.kaleyra.io/docs/whatsapp-callback-url",
    "rate_limit_requests": 20,
    "rate_limit_window": "second",
    "sdk_packages": [
      {
        "package": "kaleyra-java",
        "language": "Java",
        "official": true,
        "repo_url": "https://github.com/kaleyra/kaleyra-java"
      }
    ],
    "mcp_url": null,
    "quickstart_url": "https://developers.kaleyra.io/docs/getting-started-with-whatsapp"
  },
  "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": "Meta provides 1,000 free service conversations per month per WABA (user-initiated only; marketing, utility, and authentication conversations are always charged). Kaleyra publishes no $0 platform plan.",
    "minimum_commitment": null,
    "self_serve_signup": true,
    "requires_sales_call": true,
    "requires_verification": true,
    "enterprise_plan_available": true,
    "price_points": []
  },
  "compliance": {
    "soc2": null,
    "hipaa": true,
    "gdpr": true,
    "iso_27001": true,
    "pci_dss": null,
    "sla_published": true,
    "sla_url": null,
    "data_retention_policy_url": null,
    "documented_rate_limits": "Maximum tested outbound message rate: 20 messages per second. WhatsApp messaging tiers: Unverified WABA: 250 business-initiated conversations per rolling 24 hours; TIER_1K: 1,000 per 24 hours; TIER_10K: 10,000 per 24 hours; TIER_100K: 100,000 per 24 hours; TIER_UNLIMITED: unrestricted. Tier advancement requires quality rating maintained and 2x current tier volume within 7 days.",
    "known_restrictions": [
      "Requires Facebook Business Manager account for embedded signup",
      "Unverified WABA limited to 250 conversations/day and 2 phone numbers; Meta Business Verification needed to scale",
      "Existing WhatsApp numbers from another BSP cannot be migrated to Kaleyra; new number creation required",
      "Once registered on Business API, numbers cannot revert to consumer WhatsApp apps",
      "WhatsApp Pay available only in India (via Razorpay and PayU)",
      "Template pre-approval by Meta required",
      "24-hour customer service window applies to user-initiated sessions",
      "Quality-rating throttling: Meta reduces tier if quality rating stays 'low' for 7 consecutive days",
      "Callback Profile ID required for webhooks; direct Callback URL configuration not supported in V2 API",
      "No sandbox/test number available; pricing is contact-sales only",
      "Account setup takes 2-3 weeks including approval, verification, and configuration"
    ]
  },
  "developer": {
    "docs_url": "https://developer.tatacommunications.com/",
    "api_reference_url": null,
    "openapi_spec_url": null,
    "postman_collection_url": null,
    "changelog_url": null,
    "status_page_url": null,
    "llms_txt_url": "https://www.tatacommunications.com/llms.txt",
    "markdown_docs_url": null,
    "rendering": "static"
  },
  "adoption": {
    "launched_at": "2019-01-01",
    "ga_date": null,
    "github_stars": null,
    "github_stars_at": null,
    "notable_customers": [
      "Shiprocket",
      "Verisure",
      "Isansys",
      "AirAsia"
    ]
  },
  "scores": {
    "agent_friendliness": 35,
    "pricing_transparency": 0,
    "setup_speed": 50,
    "docs_quality": 25,
    "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": "website_url",
      "url": "https://www.kaleyra.com/whatsapp/",
      "excerpt": "Redirect URL: https://www.tatacommunications.com/kaleyra/cpaas/whatsapp-business-api — Status: 301 Moved Permanently",
      "confidence": "high"
    },
    {
      "field": "website_url",
      "url": "https://www.tatacommunications.com/kaleyra/cpaas/whatsapp-business-api",
      "excerpt": "Tata Communications offers the WhatsApp Business Platform through its Kaleyra.ai Customer Experience Platform. They position themselves as a 'Meta Premier Partner FY26.'",
      "confidence": "high"
    },
    {
      "field": "categories",
      "url": "https://www.tatacommunications.com/kaleyra/cpaas/whatsapp-business-api",
      "excerpt": "WhatsApp Business API — product page focused exclusively on WhatsApp messaging capabilities; SMS and voice are separate products on the broader Kaleyra CPaaS platform",
      "confidence": "high"
    },
    {
      "field": "categories",
      "url": "https://developers.kaleyra.io/",
      "excerpt": "Kaleyra.io, WhatsApp, SMS, Email, Voice, Video, Chatbot and OTP API: all you need to know — these are distinct API products within the platform, not the same WhatsApp API product",
      "confidence": "high"
    },
    {
      "field": "vendor_description",
      "url": "https://www.tatacommunications.com/kaleyra/cpaas/whatsapp-business-api",
      "excerpt": "Send images, videos, documents, lists, and more to create interactive and engaging customer experiences",
      "confidence": "high"
    },
    {
      "field": "requires_sales_call",
      "url": "https://zixflow.com/blog/whatsapp-api-providers/",
      "excerpt": "Kaleyra does not provide any pricing information on its website. You will have to contact its sales team to receive a custom quotation.",
      "confidence": "high"
    },
    {
      "field": "requires_sales_call",
      "url": "https://www.tatacommunications.com/kaleyra/cpaas",
      "excerpt": "Talk To An Expert and Contact Us buttons throughout; no self-serve checkout or published pricing tiers found",
      "confidence": "high"
    },
    {
      "field": "self_serve_signup",
      "url": "https://developers.kaleyra.io/docs/embedded-signup",
      "excerpt": "The embedded signup feature enables you to register for the WhatsApp Business Platform directly from the kaleyra.io application, and the feature significantly accelerates your onboarding process and makes the entire process easier.",
      "confidence": "medium"
    },
    {
      "field": "self_serve_signup",
      "url": "https://www.tatacommunications.com/kaleyra/cpaas",
      "excerpt": "New customer? Start here — signup entry point exists, though commercial pricing requires sales engagement",
      "confidence": "medium"
    },
    {
      "field": "enterprise_plan_available",
      "url": "https://www.tatacommunications.com/kaleyra/cpaas",
      "excerpt": "Enterprise-grade CPaaS. Trusted by world-class brands",
      "confidence": "high"
    },
    {
      "field": "enterprise_plan_available",
      "url": "https://www.tatacommunications.com/kaleyra/cpaas/whatsapp-business-api",
      "excerpt": "Register with a reliable provider like Tata Communications Kaleyra™, complete the verification process, and access the WhatsApp API for seamless customer communication.",
      "confidence": "high"
    },
    {
      "field": "iso_27001",
      "url": "https://www.tatacommunications.com/kaleyra/cpaas",
      "excerpt": "ISO 27001 certified and fully compliant with GDPR, HIPAA, and local telecom laws.",
      "confidence": "high"
    },
    {
      "field": "gdpr",
      "url": "https://www.tatacommunications.com/kaleyra/cpaas",
      "excerpt": "ISO 27001 certified and fully compliant with GDPR, HIPAA, and local telecom laws.",
      "confidence": "high"
    },
    {
      "field": "hipaa",
      "url": "https://www.tatacommunications.com/kaleyra/cpaas",
      "excerpt": "ISO 27001 certified and fully compliant with GDPR, HIPAA, and local telecom laws.",
      "confidence": "high"
    },
    {
      "field": "soc2",
      "url": "https://www.tatacommunications.com/solutions/cloud/compliance/soc2/",
      "excerpt": "SOC 2 compliance covers Tata Communications Vayu Cloud (managed cloud/IaaS) services only — compute, network, storage, databases, middleware. Kaleyra CPaaS messaging products are not in scope.",
      "confidence": "high"
    },
    {
      "field": "soc2",
      "url": "https://www.tatacommunications.com/kaleyra/cpaas",
      "excerpt": "ISO 27001 certified and fully compliant with GDPR, HIPAA, and local telecom laws. — SOC2 not mentioned for Kaleyra CPaaS",
      "confidence": "high"
    },
    {
      "field": "pci_dss",
      "url": "https://www.tatacommunications.com/solutions/cloud/compliance/pci-dss/",
      "excerpt": "Tata Communications Ltd. is a Service Provider focusing Infrastructure as Service (IaaS) where hardware and network infrastructure is assessed. TCL does not directly store, transmit or process any cardholder data (CHD).",
      "confidence": "high"
    },
    {
      "field": "sla_published",
      "url": "https://www.tatacommunications.com/kaleyra/cpaas",
      "excerpt": "99.99% uptime, ensuring uninterrupted communication.",
      "confidence": "high"
    },
    {
      "field": "sla_published",
      "url": "https://www.tatacommunications.com/kaleyra/cpaas",
      "excerpt": "21 years of flawless SLA maintenance",
      "confidence": "high"
    },
    {
      "field": "has_published_pricing",
      "url": "https://www.tatacommunications.com/kaleyra/cpaas",
      "excerpt": "No pricing information, plans, or tiers are disclosed on this page",
      "confidence": "high"
    },
    {
      "field": "has_published_pricing",
      "url": "https://zixflow.com/blog/whatsapp-api-providers/",
      "excerpt": "Kaleyra does not provide any pricing information on its website. You will have to contact its sales team to receive a custom quotation.",
      "confidence": "high"
    },
    {
      "field": "free_tier_details",
      "url": "https://developers.kaleyra.io/docs/whatsapp-conversations",
      "excerpt": "Each WhatsApp Business Account receives 1,000 free Service conversations each month per WABA. Marketing, Utility, and Authentication conversations are excluded from this free allocation and are always charged.",
      "confidence": "high"
    },
    {
      "field": "documented_rate_limits",
      "url": "https://developers.kaleyra.io/docs/capacity-and-messaging-limits",
      "excerpt": "The maximum tested outbound message rate is 20 messages per second. WhatsApp implements two capacity throttling mechanisms: Request rate-limiting (returns 429 errors) and Concurrent rate-limiting (returns 503 errors).",
      "confidence": "high"
    },
    {
      "field": "sandbox_available",
      "url": "https://developers.kaleyra.io/docs/frequently-asked-questions",
      "excerpt": "No sandbox/test environment, rate limits, pricing, or regional support details appear in provided documentation.",
      "confidence": "high"
    },
    {
      "field": "webhooks_supported",
      "url": "https://developers.kaleyra.io/docs/whatsapp-messages-api-v2-overview",
      "excerpt": "Only the Callback Profile ID is supported for callbacks; the Callback URL is not applicable. Incoming message and status update webhooks include: Delivery receipts (sent, delivered, read, failed), Mobile-originated (MO) message events, Payment and opt-out status updates, Template approval notifications.",
      "confidence": "high"
    },
    {
      "field": "supported_regions",
      "url": "https://www.tatacommunications.com/kaleyra/cpaas/whatsapp-business-api",
      "excerpt": "WhatsApp is available in over 180 countries, so you can reach your customers wherever they are",
      "confidence": "high"
    },
    {
      "field": "known_restrictions (number migration)",
      "url": "https://developers.kaleyra.io/docs/frequently-asked-questions",
      "excerpt": "If you already have a WhatsApp account integrated with another vendor, you cannot migrate the same account to Kaleyra",
      "confidence": "high"
    },
    {
      "field": "base_url",
      "url": "https://developers.kaleyra.io/docs/whatsapp_api_v2_send-interactive-list-messages",
      "excerpt": "curl -X POST 'https://api.in.kaleyra.io/v2/HXAP16XXXXXX97IN/whatsapp/+91XXXXXXXXXX/messages' -H 'Content-Type: application/json' -H 'api-key: Axxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx3'",
      "confidence": "high"
    },
    {
      "field": "auth_methods",
      "url": "https://developers.kaleyra.io/docs/whatsapp-api-v2-send-authentication-template-messages",
      "excerpt": "Header Name: api-key ... Format: Bearer token passed as a header value ... -H 'api-key: <api-key>'",
      "confidence": "high"
    },
    {
      "field": "api_version",
      "url": "https://developers.kaleyra.io/docs/whatsapp-api-v2-send-authentication-template-messages",
      "excerpt": "API Version: V2 (WhatsApp API V2)",
      "confidence": "high"
    },
    {
      "field": "versioning_scheme",
      "url": "https://developers.kaleyra.io/docs/whatsapp-template-api-v2-create-template",
      "excerpt": "https://api.in.kaleyra.io/v2/HXAP16XXXXXX97IN/whatsapp/1090XXXXXXXXXXXX/message_templates",
      "confidence": "high"
    },
    {
      "field": "error_format",
      "url": "https://developers.kaleyra.io/docs/whatsapp-template-api-v2-create-template",
      "excerpt": "Errors include structured code, message, data, and error fields. Common status codes: 400 (malformed payload), 401 (authentication), 429 (rate limit), 500 (server error).",
      "confidence": "high"
    },
    {
      "field": "rate_limit_window",
      "url": "https://developers.kaleyra.io/docs/capacity-and-messaging-limits",
      "excerpt": "The maximum tested outbound message rate is 20 messages per second.",
      "confidence": "high"
    },
    {
      "field": "webhook_signing",
      "url": "https://developers.kaleyra.io/docs/whatsapp-callback-url",
      "excerpt": "Whitelisting the Callback URL is mandatory before passing the Callback URL.",
      "confidence": "medium"
    },
    {
      "field": "requires_verification",
      "url": "https://developers.kaleyra.io/docs/getting-started-with-whatsapp",
      "excerpt": "When you apply for a WhatsApp Business account, your application will go through a verification process to vet your business as a legal entity.",
      "confidence": "high"
    },
    {
      "field": "sdk_packages",
      "url": "https://github.com/kaleyra/kaleyra-java",
      "excerpt": "A JAVA library for consuming Kaleyra REST APIs",
      "confidence": "high"
    },
    {
      "field": "notable_customers",
      "url": "https://www.tatacommunications.com/kaleyra/cpaas/whatsapp-business-api",
      "excerpt": "Shiprocket (45% reduction in Return-to-Origin losses) ... Isansys (Remote Patient Monitoring) ... Verisure (Security systems provider)",
      "confidence": "high"
    },
    {
      "field": "starting_price_usd",
      "url": "https://zixflow.com/blog/whatsapp-api-providers/",
      "excerpt": "Kaleyra does not provide any pricing information on its website. You will have to contact its sales team to receive a custom quotation.",
      "confidence": "high"
    },
    {
      "field": "documented_rate_limits",
      "url": "https://developers.kaleyra.io/docs/whatsapp-messaging-limits",
      "excerpt": "TIER_1K: 1,000 conversations per 24 hours; TIER_10K: 10,000 conversations per 24 hours; TIER_100K: 100,000 conversations per 24 hours; TIER_UNLIMITED: Unrestricted conversations. Unverified accounts: Flat 250 conversation limit per rolling 24-hour window.",
      "confidence": "high"
    },
    {
      "field": "supported_actions (WhatsApp Pay)",
      "url": "https://developers.kaleyra.io/docs/whatsapp-pay",
      "excerpt": "WhatsApp Pay is currently available only for businesses in India. The feature is enabled through two payment gateway partners: Razorpay and PayU.",
      "confidence": "high"
    },
    {
      "field": "supported_regions",
      "url": "https://www.tatacommunications.com/kaleyra/cpaas",
      "excerpt": "190+ countries covered",
      "confidence": "high"
    },
    {
      "field": "sdk_languages",
      "url": "https://github.com/kaleyra",
      "excerpt": "kaleyra-java — A JAVA library for consuming Kaleyra REST APIs (2 stars). The organization appears to focus primarily on Java; no Python, Node.js, or JavaScript SDK libraries found.",
      "confidence": "medium"
    },
    {
      "field": "known_restrictions (setup timeline)",
      "url": "https://developers.kaleyra.io/docs/frequently-asked-questions",
      "excerpt": "2-3 weeks for the process, including approval, verification, and setting up of the account.",
      "confidence": "high"
    },
    {
      "field": "base_url",
      "url": "https://developers.kaleyra.io/docs/whatsapp-api-v2-send-authentication-template-messages",
      "excerpt": "Base URL Structure: https://<api_domain>/v2/<SID> ... India: api.in.kaleyra.io | Singapore/Asia-Pacific: api.ap.kaleyra.io | Europe: api.eu.kaleyra.io",
      "confidence": "high"
    },
    {
      "field": "auth_methods",
      "url": "https://developers.kaleyra.io/docs/whatsapp-template-api-v2-create-template",
      "excerpt": "Two required headers: api-key: Your generated API key | Content-Type: application/json",
      "confidence": "high"
    },
    {
      "field": "api_version",
      "url": "https://developers.kaleyra.io/docs/whatsapp-messages-api-v2-overview",
      "excerpt": "WhatsApp Message API V2",
      "confidence": "high"
    },
    {
      "field": "error_format",
      "url": "https://developers.kaleyra.io/docs/whatsapp_api_v2_send-interactive-list-messages",
      "excerpt": "{\"code\": \"RBC001\", \"message\": \"Incorrect SID or API key.\", \"error\": {\"error\": \"Incorrect SID or API key.\"}}",
      "confidence": "high"
    },
    {
      "field": "rate_limit_requests",
      "url": "https://developers.kaleyra.io/docs/capacity-and-messaging-limits",
      "excerpt": "The maximum tested outbound message rate is 20 messages per second.",
      "confidence": "high"
    },
    {
      "field": "webhook_signing",
      "url": "https://developers.kaleyra.io/docs/callback-basic-authentication",
      "excerpt": "Basic authentication is an authentication method in which a security token, containing base-64 encoded user credentials such as username and password, is transmitted through the Authorization header.",
      "confidence": "medium"
    },
    {
      "field": "webhook_events_url",
      "url": "https://developers.kaleyra.io/docs/whatsapp-callback-url",
      "excerpt": "Configure WhatsApp Callback URL",
      "confidence": "high"
    },
    {
      "field": "requires_verification",
      "url": "https://www.tatacommunications.com/kaleyra/cpaas/whatsapp-business-api",
      "excerpt": "Register with a reliable provider like Tata Communications Kaleyra™, complete the verification process, and access the WhatsApp API for seamless customer communication.",
      "confidence": "high"
    },
    {
      "field": "launched_at",
      "url": "https://www.prnewswire.com/news-releases/kaleyra-brings-whatsapp-business-platform-to-us-solution-portfolio-to-enhance-customer-engagement-301885633.html",
      "excerpt": "Kaleyra has been a Solution Provider for the WhatsApp Business Platform since 2019, with successful implementations across sectors ranging from fintech to retail in India and Europe.",
      "confidence": "medium"
    },
    {
      "field": "notable_customers",
      "url": "https://www.tatacommunications.com/resourcehub/products-solution-customer-interaction-suite/airasia-tata-communications-kaleyra",
      "excerpt": "AirAsia Boosts Customer Engagement with Tata Communications Kaleyra",
      "confidence": "high"
    },
    {
      "field": "api_style",
      "url": "https://developers.kaleyra.io/docs/whatsapp_api_v2_send-interactive-list-messages",
      "excerpt": "curl -X POST 'https://api.in.kaleyra.io/v2/HXAP16XXXXXX97IN/whatsapp/+91XXXXXXXXXX/messages' -H 'Content-Type: application/json'",
      "confidence": "high"
    }
  ],
  "fields_not_found": [
    "minimum_commitment",
    "pci_dss (Tata Communications PCI DSS covers IaaS only, not Kaleyra CPaaS messaging)",
    "soc2 (no SOC2 claim found for Kaleyra CPaaS; Tata Communications SOC2 covers Vayu Cloud IaaS only)",
    "sdk_languages (only Java confirmed on GitHub; no official multi-language SDK list published)",
    "mcp_server_available (no official Kaleyra MCP server found)",
    "deprecation_policy_url",
    "sla_url",
    "data_retention_policy_url",
    "starting_price_usd",
    "price_basis",
    "free_tier_limit",
    "ga_date",
    "idempotency_supported (not published, inferred absent)",
    "mcp_url"
  ],
  "source_confidence": "high",
  "last_verified_at": "2026-06-16T00: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/kaleyra",
        "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/kaleyra/{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"
      }
    ]
  }
}