{
  "name": "Cartesia Line",
  "slug": "cartesia-line",
  "website_url": "https://cartesia.ai/line",
  "vendor_description": "\"Turn any text agent into a world-class conversational agent, deployed anywhere.\"",
  "categories": [
    "voice-agents"
  ],
  "summary": "Cartesia Line is a telephony platform for building and deploying AI voice agents, supporting inbound call handling, outbound calling, batch dialing, SIP trunking, and real-time conversation via a WebSocket API. It targets developers and businesses automating customer support or voice workflows, with customers including ServiceNow, Vapi, LiveKit, and Replicant. Pricing starts at $0.06 per minute with a free tier of 8 concurrent calls and 20,000 credits per month; enterprise plans are available. The platform holds SOC 2 Type 2, HIPAA, GDPR, and PCI DSS certifications, and ships SDKs for Python and JavaScript/TypeScript.",
  "capabilities": {
    "supported_actions": [
      "realtime_conversation",
      "inbound_telephony",
      "outbound_telephony",
      "sip_trunking",
      "call_transfer",
      "function_calling",
      "tool_calling",
      "interruption_handling",
      "byo_llm",
      "knowledge_base",
      "batch_calling",
      "call_recording",
      "webhooks",
      "multi_agent_handoff",
      "web_search_tool",
      "dtmf_support",
      "send_dtmf",
      "agent_builder_no_code",
      "websocket_audio_streaming",
      "custom_pronunciations",
      "ambient_audio",
      "call_transcripts",
      "observability_metrics",
      "http_server_tool",
      "post_call_analysis"
    ],
    "supported_regions": [
      "United States (Cartesia Numbers)",
      "Any country available in Twilio (via Twilio integration)"
    ],
    "supported_languages": [
      "English (US)",
      "English (GB)",
      "English (Canada)",
      "English (New Zealand)",
      "English (South Africa)",
      "Spanish (Mexico)",
      "Spanish",
      "German",
      "French",
      "French (Canada)",
      "Italian",
      "Hindi",
      "Mandarin Chinese",
      "Brazilian Portuguese",
      "Arabic (UAE)",
      "Hebrew",
      "Thai",
      "40+ languages via Sonic TTS"
    ],
    "input_types": [
      "PSTN phone call",
      "audio stream (WebSocket)",
      "SIP (beta)"
    ],
    "output_types": [
      "audio stream",
      "call transcript",
      "webhook events",
      "call recording",
      "observability metrics",
      "call summary",
      "post-call analysis"
    ],
    "webhooks_supported": true,
    "sandbox_available": false,
    "sdk_languages": [
      "Python (Line SDK)",
      "Python (inference SDK)",
      "JavaScript/TypeScript"
    ],
    "mcp_server_available": false
  },
  "integration": {
    "api_style": "websocket",
    "base_url": "https://api.cartesia.ai",
    "api_version": "2025-04-16",
    "versioning_scheme": "header",
    "stability": "ga",
    "deprecation_policy_url": null,
    "auth_methods": [
      "api_key"
    ],
    "auth_docs_url": "https://docs.cartesia.ai/use-the-api/api-conventions",
    "idempotency_supported": null,
    "error_format": "vendor-specific JSON (error_code, title, message, request_id, optional doc_url) for Cartesia-Version >= 2026-03-01; legacy plain-text for earlier versions",
    "webhook_signing": null,
    "webhook_events_url": null,
    "rate_limit_requests": 60,
    "rate_limit_window": "concurrent calls",
    "sdk_packages": [
      {
        "package": "cartesia-line",
        "language": "Python (Line SDK)",
        "official": true,
        "repo_url": "https://github.com/cartesia-ai/line"
      },
      {
        "package": "cartesia",
        "language": "Python (inference SDK)",
        "official": true,
        "repo_url": "https://github.com/cartesia-ai/cartesia-python"
      },
      {
        "package": "@cartesia/cartesia-js",
        "language": "JavaScript/TypeScript",
        "official": true,
        "repo_url": "https://github.com/cartesia-ai/cartesia-js"
      }
    ],
    "mcp_url": null,
    "quickstart_url": "https://docs.cartesia.ai/line/start-building/quickstart"
  },
  "pricing": {
    "pricing_model": "hybrid",
    "has_published_pricing": true,
    "starting_price_usd": "0.0600",
    "price_basis": "minute",
    "free_tier_available": true,
    "free_tier_limit": "8 concurrent calls on free plan; 20K credits/month",
    "free_tier_details": "Free plan at $0/month with 20K credits/month and $1/month prepaid agent budget; 1 voice agent slot; 8 concurrent calls. Voice agent call duration billed at $0.06/minute; telephony $0.014/minute for Cartesia phone numbers.",
    "minimum_commitment": null,
    "self_serve_signup": true,
    "requires_sales_call": false,
    "requires_verification": false,
    "enterprise_plan_available": true,
    "price_points": [
      {
        "plan": "Free",
        "item": "Platform subscription",
        "amount_usd": "0.0000",
        "amount_percent": null,
        "per": "month",
        "currency": "USD",
        "source_url": "https://www.cartesia.ai/pricing"
      },
      {
        "plan": "Pro",
        "item": "Platform subscription",
        "amount_usd": "5.0000",
        "amount_percent": null,
        "per": "month",
        "currency": "USD",
        "source_url": "https://www.cartesia.ai/pricing"
      },
      {
        "plan": "Startup",
        "item": "Platform subscription",
        "amount_usd": "49.0000",
        "amount_percent": null,
        "per": "month",
        "currency": "USD",
        "source_url": "https://www.cartesia.ai/pricing"
      },
      {
        "plan": "Scale",
        "item": "Platform subscription",
        "amount_usd": "299.0000",
        "amount_percent": null,
        "per": "month",
        "currency": "USD",
        "source_url": "https://www.cartesia.ai/pricing"
      },
      {
        "plan": "Free",
        "item": "Prepaid agents budget (monthly recurring credit toward voice agent calls)",
        "amount_usd": "1.0000",
        "amount_percent": null,
        "per": "month included",
        "currency": "USD",
        "source_url": "https://www.cartesia.ai/pricing"
      },
      {
        "plan": "Pro",
        "item": "Prepaid agents budget (monthly recurring credit toward voice agent calls)",
        "amount_usd": "5.0000",
        "amount_percent": null,
        "per": "month included",
        "currency": "USD",
        "source_url": "https://www.cartesia.ai/pricing"
      },
      {
        "plan": "Startup",
        "item": "Prepaid agents budget (monthly recurring credit toward voice agent calls)",
        "amount_usd": "49.0000",
        "amount_percent": null,
        "per": "month included",
        "currency": "USD",
        "source_url": "https://www.cartesia.ai/pricing"
      },
      {
        "plan": "Scale",
        "item": "Prepaid agents budget (monthly recurring credit toward voice agent calls)",
        "amount_usd": "299.0000",
        "amount_percent": null,
        "per": "month included",
        "currency": "USD",
        "source_url": "https://www.cartesia.ai/pricing"
      },
      {
        "plan": "All plans",
        "item": "Voice agent call duration (orchestration)",
        "amount_usd": "0.0600",
        "amount_percent": null,
        "per": "minute",
        "currency": "USD",
        "source_url": "https://www.cartesia.ai/pricing"
      },
      {
        "plan": "All plans",
        "item": "Telephony (Cartesia-provided phone number)",
        "amount_usd": "0.0140",
        "amount_percent": null,
        "per": "minute",
        "currency": "USD",
        "source_url": "https://www.cartesia.ai/pricing"
      }
    ]
  },
  "compliance": {
    "soc2": "type_2",
    "hipaa": true,
    "gdpr": true,
    "iso_27001": null,
    "pci_dss": true,
    "sla_published": false,
    "sla_url": null,
    "data_retention_policy_url": "https://cartesia.ai/legal/privacy.html",
    "documented_rate_limits": "Outbound calling: 1 call per second; Concurrent calls by plan: Free=8, Pro=12, Startup=20, Scale=60. Batch calling: up to 1,000 recipients per batch. Agent compute: 1GB memory and 0.5 vCPU per call (higher on request).",
    "known_restrictions": [
      "Cartesia-provisioned phone numbers are US-only; international coverage requires BYO Twilio account",
      "SIP trunking is in Beta (early access, contact support@cartesia.ai)",
      "No dedicated sandbox/test environment documented",
      "BYO-voice (custom voice upload for TTS) not supported - uses Cartesia Sonic voice library only",
      "Outbound calls limited to 1 per second rate"
    ]
  },
  "developer": {
    "docs_url": "https://docs.cartesia.ai/get-started/overview",
    "api_reference_url": "https://docs.cartesia.ai/use-the-api/api-conventions",
    "openapi_spec_url": null,
    "postman_collection_url": null,
    "changelog_url": "https://docs.cartesia.ai/changelog",
    "status_page_url": "https://status.cartesia.ai",
    "llms_txt_url": "https://docs.cartesia.ai/llms.txt",
    "markdown_docs_url": "https://docs.cartesia.ai/get-started/overview.md",
    "rendering": "static"
  },
  "adoption": {
    "launched_at": "2025-08-19",
    "ga_date": "2025-08-19",
    "github_stars": null,
    "github_stars_at": null,
    "notable_customers": [
      "ServiceNow",
      "Maven AGI",
      "Retell",
      "Vapi",
      "LiveKit",
      "Replicant",
      "Thoughtly",
      "Cresta",
      "Quora"
    ]
  },
  "scores": {
    "agent_friendliness": 55,
    "pricing_transparency": 100,
    "setup_speed": 85,
    "docs_quality": 70,
    "procurement_friction": 100,
    "trust_readiness": 65,
    "best_for": [
      "Prototypes and side projects - free to start, no sales call",
      "Regulated or enterprise workloads - compliance attestations and an enterprise plan",
      "AI agents and automation - an agent-ready surface (MCP / llms.txt)"
    ],
    "avoid_if": []
  },
  "sources": [
    {
      "field": "vendor_description",
      "url": "https://cartesia.ai/agents",
      "excerpt": "Turn any text agent into a world-class conversational agent, deployed anywhere.",
      "confidence": "high"
    },
    {
      "field": "categories",
      "url": "https://cartesia.ai/ink",
      "excerpt": "Ink is positioned as a distinct standalone speech-to-text product alongside Sonic (text-to-speech) and Line (voice agents)",
      "confidence": "high"
    },
    {
      "field": "categories",
      "url": "https://cartesia.ai/sonic",
      "excerpt": "Sonic: The fastest and most natural text to speech model — 40+ languages and a wide range of accents, all with native-speaker quality voices",
      "confidence": "high"
    },
    {
      "field": "pricing_model",
      "url": "https://www.cartesia.ai/pricing",
      "excerpt": "Free $0/mo; Pro $5/mo; Startup $49/mo; Scale $299/mo; Enterprise Custom. Call duration: $0.06 per minute. Telephony: $0.014 per minute when using a Cartesia-provided phone number.",
      "confidence": "high"
    },
    {
      "field": "free_tier_available",
      "url": "https://www.cartesia.ai/pricing",
      "excerpt": "Free $0/mo — 20K credits / month, $1 prepaid agents/month, 1 agent slot, 8 concurrent calls. Start free. Pause or cancel anytime.",
      "confidence": "high"
    },
    {
      "field": "soc2",
      "url": "https://cartesia.ai/agents",
      "excerpt": "SOC 2 Type 2 certified",
      "confidence": "high"
    },
    {
      "field": "hipaa",
      "url": "https://cartesia.ai/agents",
      "excerpt": "HIPAA compliant",
      "confidence": "high"
    },
    {
      "field": "gdpr",
      "url": "https://cartesia.ai/blog/gdpr-compliance",
      "excerpt": "our text-to-speech platform is now GDPR compliant",
      "confidence": "high"
    },
    {
      "field": "pci_dss",
      "url": "https://cartesia.ai/blog/gdpr-compliance",
      "excerpt": "PCI-DSS (service level provider)",
      "confidence": "high"
    },
    {
      "field": "sla_published",
      "url": "https://status.cartesia.ai",
      "excerpt": "Voice Agents: 99.89% uptime — status page shows historical metrics only; no published SLA, contractual uptime guarantee, or penalty clause language found",
      "confidence": "high"
    },
    {
      "field": "documented_rate_limits",
      "url": "https://docs.cartesia.ai/line/infrastructure/scaling",
      "excerpt": "Each API call receives 1GB of memory and 0.5 vCPU.",
      "confidence": "high"
    },
    {
      "field": "supported_actions",
      "url": "https://docs.cartesia.ai/line/infrastructure/observability",
      "excerpt": "Supported webhook events: call_started, call_completed, call_failed, call_turn, post_call_analysis",
      "confidence": "high"
    },
    {
      "field": "input_types",
      "url": "https://docs.cartesia.ai/line/integrations/telephony/phone-numbers",
      "excerpt": "Cartesia Numbers: US only provisioning; Twilio Numbers: Support extends globally to any country available in Twilio",
      "confidence": "high"
    },
    {
      "field": "supported_languages",
      "url": "https://cartesia.ai/sonic",
      "excerpt": "40+ languages and a wide range of accents, all with native-speaker quality voices",
      "confidence": "medium"
    },
    {
      "field": "sdk_languages",
      "url": "https://github.com/cartesia-ai/cartesia-js",
      "excerpt": "The JavaScript client for the Cartesia API. npm install @cartesia/cartesia-js",
      "confidence": "high"
    },
    {
      "field": "pricing_model",
      "url": "https://www.cartesia.ai/pricing",
      "excerpt": "Free: 20K credits/month + $1 prepaid agents/month; Pro: 100K credits/month + $5 prepaid agents/month; Startup: 1.25M credits/month + $49 prepaid agents/month; Scale: 8M credits/month + $299 prepaid agents/month",
      "confidence": "high"
    },
    {
      "field": "enterprise_plan_available",
      "url": "https://www.cartesia.ai/pricing",
      "excerpt": "Enterprise Plan - Custom pricing and volume-based rates - Requires contacting sales - Includes DPAs, BAAs, SSO, and security features",
      "confidence": "high"
    },
    {
      "field": "soc2",
      "url": "https://cartesia.ai/blog/gdpr-compliance",
      "excerpt": "SOC 2 Type II, PCI-DSS (service level provider), HIPAA, and optional Zero Data Retention — Listed among security foundations",
      "confidence": "high"
    },
    {
      "field": "hipaa",
      "url": "https://cartesia.ai/blog/gdpr-compliance",
      "excerpt": "SOC 2 Type II, PCI-DSS (service level provider), HIPAA, and optional Zero Data Retention",
      "confidence": "high"
    },
    {
      "field": "gdpr",
      "url": "https://www.cartesia.ai/legal/dpa",
      "excerpt": "Service Provider shall comply with the obligations of Applicable Data Protection Laws",
      "confidence": "high"
    },
    {
      "field": "iso_27001",
      "url": "https://cartesia.ai/blog/gdpr-compliance",
      "excerpt": "SOC 2 Type II, PCI-DSS (service level provider), HIPAA, and optional Zero Data Retention — ISO 27001 not mentioned in this compliance listing",
      "confidence": "high"
    },
    {
      "field": "documented_rate_limits",
      "url": "https://docs.cartesia.ai/line/infrastructure/scaling",
      "excerpt": "Concurrency Limits: Free=8, Pro=12, Startup=20, Scale=60 concurrent calls. When triggering outbound calls, you are limited to triggering one call per second.",
      "confidence": "high"
    },
    {
      "field": "supported_actions",
      "url": "https://docs.cartesia.ai/line/sdk/tools",
      "excerpt": "end_call: Ends the call and disconnects; transfer_call: Transfers to another phone number in E.164 format; web_search: Retrieves real-time information from the internet; knowledge_base: Searches attached documents; send_dtmf: Sends DTMF tones during calls; agent_as_handoff: Creates a handoff tool from another agent, enabling multi-agent workflows; http_server_tool: Calls REST APIs via JSON schemas",
      "confidence": "high"
    },
    {
      "field": "webhooks_supported",
      "url": "https://docs.cartesia.ai/line/infrastructure/observability",
      "excerpt": "Cartesia enables webhook integration for call monitoring. Webhooks require HTTPS endpoint accepting POST requests with application/json. Secret verification via the x-webhook-secret header.",
      "confidence": "high"
    },
    {
      "field": "input_types",
      "url": "https://docs.cartesia.ai/line/integrations/websocket-api",
      "excerpt": "wss://api.cartesia.ai/agents/stream/{agent_id} — The WebSocket connection uses JSON messages for control events and base64-encoded audio for media. Input formats: mulaw_8000, pcm_16000, pcm_24000, pcm_44100.",
      "confidence": "high"
    },
    {
      "field": "sdk_languages",
      "url": "https://github.com/cartesia-ai/line",
      "excerpt": "Line is a Python SDK for building intelligent, low-latency voice agents. Package: cartesia-line. Installation: uv add cartesia-line",
      "confidence": "high"
    },
    {
      "field": "known_restrictions",
      "url": "https://docs.cartesia.ai/line/integrations/telephony/phone-numbers",
      "excerpt": "Cartesia Numbers: US only — all Cartesia-managed numbers are from the US. Twilio numbers: pay your Twilio usage rates directly to Twilio based on actual usage.",
      "confidence": "high"
    },
    {
      "field": "auth_docs_url",
      "url": "https://docs.cartesia.ai/use-the-api/api-conventions",
      "excerpt": "Each request you send our API should have a Cartesia-Version header containing the date (YYYY-MM-DD). Our versioning scheme is inspired by the Anthropic API.",
      "confidence": "high"
    },
    {
      "field": "api_style",
      "url": "https://docs.cartesia.ai/use-the-api/api-conventions",
      "excerpt": "All endpoints use HTTPS. HTTP is not supported.",
      "confidence": "high"
    },
    {
      "field": "api_version",
      "url": "https://docs.cartesia.ai/get-started/make-an-api-request",
      "excerpt": "API Version: Cartesia-Version: 2025-04-16",
      "confidence": "high"
    },
    {
      "field": "stability",
      "url": "https://cartesia.ai/blog/introducing-line-for-voice-agents",
      "excerpt": "Line is available today to all developers",
      "confidence": "high"
    },
    {
      "field": "sdk_packages",
      "url": "https://github.com/cartesia-ai/cartesia-python",
      "excerpt": "The official Cartesia client for Python. pip install cartesia",
      "confidence": "high"
    },
    {
      "field": "quickstart_url",
      "url": "https://docs.cartesia.ai/line/sdk/overview",
      "excerpt": "Start with the Quickstart to build and deploy your first agent.",
      "confidence": "high"
    },
    {
      "field": "rate_limit_requests",
      "url": "https://docs.cartesia.ai/use-the-api/concurrency-limits-and-timeouts",
      "excerpt": "Scale plan: TTS Requests 15, STT Requests 60. Exceeding limits returns a 429 Too Many Requests error.",
      "confidence": "high"
    },
    {
      "field": "rate_limit_window",
      "url": "https://docs.cartesia.ai/use-the-api/concurrency-limits-and-timeouts",
      "excerpt": "Each request is treated as a separate context and counts toward your concurrency limit",
      "confidence": "high"
    },
    {
      "field": "data_retention_policy_url",
      "url": "https://cartesia.ai/legal/privacy.html",
      "excerpt": "Once we've processed your request, we will no longer use the selected categories of Content to train our models in the future",
      "confidence": "high"
    },
    {
      "field": "starting_price_usd",
      "url": "https://www.cartesia.ai/pricing",
      "excerpt": "Call duration: $0.06 per minute; Telephony: $0.014 per minute when using a Cartesia-provided phone number",
      "confidence": "high"
    },
    {
      "field": "free_tier_limit",
      "url": "https://www.cartesia.ai/pricing",
      "excerpt": "Free: $0, 20K credits/month, 1 agent slot. Concurrent calls: 8 (Free)",
      "confidence": "high"
    },
    {
      "field": "ga_date",
      "url": "https://cartesia.ai/blog/introducing-line-for-voice-agents",
      "excerpt": "Line is available today to all developers, and as part of the launch, all subscription tiers receive their equivalent monthly plan dollars prepaid towards agents",
      "confidence": "high"
    },
    {
      "field": "notable_customers",
      "url": "https://cartesia.ai/customers/servicenow",
      "excerpt": "Cartesia Voice AI Technology Integrated with ServiceNow AI Voice Agents",
      "confidence": "high"
    },
    {
      "field": "auth_methods",
      "url": "https://docs.cartesia.ai/use-the-api/api-conventions",
      "excerpt": "Server requests: Use standard API keys from play.cartesia.ai/keys with header Authorization: Bearer <api_key>",
      "confidence": "high"
    },
    {
      "field": "api_style",
      "url": "https://docs.cartesia.ai/line/integrations/websocket-api",
      "excerpt": "wss://api.cartesia.ai/agents/stream/{agent_id}",
      "confidence": "high"
    },
    {
      "field": "base_url",
      "url": "https://docs.cartesia.ai/use-the-api/api-conventions",
      "excerpt": "Base URL: https://api.cartesia.ai (WebSocket: wss://)",
      "confidence": "high"
    },
    {
      "field": "versioning_scheme",
      "url": "https://docs.cartesia.ai/use-the-api/api-conventions",
      "excerpt": "Each request you send our API should have a Cartesia-Version header containing the date (YYYY-MM-DD) when you tested your integration.",
      "confidence": "high"
    },
    {
      "field": "sdk_packages",
      "url": "https://github.com/cartesia-ai/line",
      "excerpt": "Line is a Python SDK for building intelligent, low-latency voice agents. Package: cartesia-line. Installation: uv add cartesia-line",
      "confidence": "high"
    },
    {
      "field": "sdk_packages",
      "url": "https://github.com/cartesia-ai/cartesia-js",
      "excerpt": "The JavaScript client for the Cartesia API. npm install @cartesia/cartesia-js",
      "confidence": "high"
    },
    {
      "field": "error_format",
      "url": "https://docs.cartesia.ai/use-the-api/api-conventions",
      "excerpt": "For Cartesia-Version 2026-03-01 and newer, structured JSON errors include: error_code (machine-readable), title (summary), message (explanation), request_id (debugging), and optional doc_url. WebSocket/SSE errors add status_code and context_id fields.",
      "confidence": "high"
    },
    {
      "field": "rate_limit_requests",
      "url": "https://www.cartesia.ai/pricing",
      "excerpt": "Concurrent calls: 8 (Free) to 60 (Scale); Custom for Enterprise",
      "confidence": "high"
    },
    {
      "field": "requires_verification",
      "url": "https://docs.cartesia.ai/get-started/make-an-api-request",
      "excerpt": "Account Required: A Cartesia account at play.cartesia.ai; API Key: Generated from the keys dashboard",
      "confidence": "high"
    },
    {
      "field": "data_retention_policy_url",
      "url": "https://www.cartesia.ai/legal/dpa",
      "excerpt": "Where the Zero Data Retention setting is enabled, Cartesia shall not store any Customer Content, including audio inputs, transcripts, or outputs derived from such content.",
      "confidence": "high"
    },
    {
      "field": "price_basis",
      "url": "https://www.cartesia.ai/pricing",
      "excerpt": "Call duration: $0.06 per minute",
      "confidence": "high"
    },
    {
      "field": "launched_at",
      "url": "https://cartesia.ai/blog/introducing-line-for-voice-agents",
      "excerpt": "Launch Date: August 19, 2025",
      "confidence": "high"
    },
    {
      "field": "notable_customers",
      "url": "https://cartesia.ai/customers",
      "excerpt": "ServiceNow, Maven AGI, Retell, Replicant, Thoughtly, Vapi, LiveKit, Rasa, Cresta, Quora, Fundamento, Lorikeet",
      "confidence": "high"
    }
  ],
  "fields_not_found": [
    "iso_27001",
    "sla_published (status page shows metrics, no contractual SLA or uptime guarantee language)",
    "mcp_server_available",
    "deprecation_policy_url",
    "mcp_url",
    "idempotency_supported",
    "webhook_signing",
    "webhook_events_url",
    "sla_url"
  ],
  "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/cartesia-line",
        "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/cartesia-line/{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"
      }
    ]
  }
}