{
  "name": "Lithic",
  "slug": "lithic",
  "website_url": "https://www.lithic.com",
  "vendor_description": "\"Programmable card issuing and money movement\" platform designed to help developers and companies \"launch fast, scale confidently, and offload complexity.\"",
  "categories": [
    "card-issuing"
  ],
  "summary": "Lithic is a programmable card issuing and money movement platform for developers and fintechs, covering virtual, physical, prepaid, debit, credit, charge, and fleet card programs in the US and Canada. Pricing is usage-based with published rates and self-serve signup; an enterprise tier is available for programs exceeding $250K monthly volume, which also unlocks physical and tokenized card issuance. The REST API supports webhooks, idempotency, and SDKs in six languages, with a sandbox environment for testing and an MCP server available. Lithic holds SOC 2 Type II, ISO 27001, and PCI DSS certifications, and counts Mercury, Novo, and Parker among its customers.",
  "capabilities": {
    "supported_actions": [
      "issue_virtual_card",
      "issue_physical_card",
      "single_use_card",
      "card_lifecycle_management",
      "spend_controls",
      "authorization_stream",
      "jit_funding",
      "push_provisioning",
      "in_app_push_provisioning",
      "web_push_provisioning",
      "tokenization",
      "3ds",
      "program_management",
      "kyc_kyb",
      "real_time_webhooks",
      "authorization_rules",
      "velocity_limits",
      "custom_code_authorization_typescript",
      "dispute_management",
      "ach_origination",
      "wire_transfers",
      "ledger_accounts",
      "settlement_api",
      "enhanced_commercial_data_l2_l3",
      "transaction_grouping",
      "multi_currency",
      "stablecoin_settlement",
      "network_token_management",
      "embedded_card_ui",
      "card_simulation_sandbox"
    ],
    "supported_regions": [
      "United States",
      "Canada"
    ],
    "supported_languages": [],
    "input_types": [
      "Visa",
      "Mastercard",
      "American Express",
      "virtual",
      "physical",
      "debit",
      "credit",
      "prepaid",
      "charge",
      "consumer",
      "commercial",
      "single-use"
    ],
    "output_types": [
      "JSON",
      "webhook events",
      "card tokens",
      "authorization events",
      "transaction data",
      "settlement reports",
      "ledger entries",
      "ACH originations",
      "wire transfers",
      "OpenAPI spec"
    ],
    "webhooks_supported": true,
    "sandbox_available": true,
    "sdk_languages": [
      "Node.js / TypeScript",
      "Python",
      "Java",
      "Kotlin",
      "Ruby",
      "Go"
    ],
    "mcp_server_available": true
  },
  "integration": {
    "api_style": "rest",
    "base_url": "https://api.lithic.com/v1",
    "api_version": "v1",
    "versioning_scheme": "url",
    "stability": "ga",
    "deprecation_policy_url": null,
    "auth_methods": [
      "api_key"
    ],
    "auth_docs_url": "https://docs.lithic.com/docs/api-basics",
    "idempotency_supported": true,
    "error_format": "vendor-specific",
    "webhook_signing": "hmac_sha256",
    "webhook_events_url": "https://docs.lithic.com/docs/types-of-events",
    "rate_limit_requests": 30,
    "rate_limit_window": "second",
    "sdk_packages": [
      {
        "package": "lithic",
        "language": "Node.js / TypeScript",
        "official": true,
        "repo_url": "https://github.com/lithic-com/lithic-node"
      },
      {
        "package": "lithic",
        "language": "Python",
        "official": true,
        "repo_url": "https://github.com/lithic-com/lithic-python"
      },
      {
        "package": "com.lithic.api:lithic-java",
        "language": "Java",
        "official": true,
        "repo_url": "https://github.com/lithic-com/lithic-java"
      },
      {
        "package": "com.lithic.api:lithic-kotlin",
        "language": "Kotlin",
        "official": true,
        "repo_url": "https://github.com/lithic-com/lithic-kotlin"
      },
      {
        "package": "lithic",
        "language": "Ruby",
        "official": true,
        "repo_url": "https://github.com/lithic-com/lithic-ruby"
      },
      {
        "package": "github.com/lithic-com/lithic-go",
        "language": "Go",
        "official": true,
        "repo_url": "https://github.com/lithic-com/lithic-go"
      }
    ],
    "mcp_url": "https://docs.lithic.com/mcp",
    "quickstart_url": "https://docs.lithic.com/docs/create-card"
  },
  "pricing": {
    "pricing_model": "usage_based",
    "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": true,
    "requires_sales_call": false,
    "requires_verification": true,
    "enterprise_plan_available": true,
    "price_points": [
      {
        "plan": "Starter",
        "item": "virtual card creation",
        "amount_usd": "0.1000",
        "amount_percent": null,
        "per": "virtual card",
        "currency": "USD",
        "source_url": "https://research.contrary.com/company/lithic"
      },
      {
        "plan": "Starter",
        "item": "interchange revenue share — first $100K monthly volume",
        "amount_usd": null,
        "amount_percent": "0.2000",
        "per": "transaction volume",
        "currency": "USD",
        "source_url": "https://research.contrary.com/company/lithic"
      },
      {
        "plan": "Starter",
        "item": "interchange revenue share — above $100K monthly volume",
        "amount_usd": null,
        "amount_percent": "0.4000",
        "per": "transaction volume",
        "currency": "USD",
        "source_url": "https://research.contrary.com/company/lithic"
      },
      {
        "plan": "All plans",
        "item": "monthly platform fee / minimum commitment",
        "amount_usd": "0.0000",
        "amount_percent": null,
        "per": "month",
        "currency": "USD",
        "source_url": "https://www.lithic.com/blog/introducing-lithic"
      },
      {
        "plan": "Enterprise",
        "item": "virtual + physical + tokenized card creation (custom rate, lower than Starter $0.10)",
        "amount_usd": null,
        "amount_percent": null,
        "per": "card",
        "currency": "USD",
        "source_url": "https://research.contrary.com/company/lithic"
      },
      {
        "plan": "Processor Only",
        "item": "usage-based fees (lowest tier; requires own sponsor bank)",
        "amount_usd": null,
        "amount_percent": null,
        "per": "card / transaction",
        "currency": "USD",
        "source_url": "https://research.contrary.com/company/lithic"
      }
    ]
  },
  "compliance": {
    "soc2": "type_2",
    "hipaa": null,
    "gdpr": null,
    "iso_27001": true,
    "pci_dss": true,
    "sla_published": true,
    "sla_url": null,
    "data_retention_policy_url": "https://www.lithic.com/legal/privacy-policy",
    "documented_rate_limits": "Read: 30 RPS; Write: 5 RPS (default production limits)",
    "known_restrictions": [
      "Lithic is not a bank - BIN sponsorship is provided via Lithic's partner sponsor banks; customers on the Starter and Enterprise tiers use Lithic's managed program (turnkey BIN sponsorship included); Processor Only tier requires the client to bring their own sponsor bank",
      "PCI DSS level not explicitly published on public pages (level not stated in trust materials)",
      "Production PAN/CVV access requires verified PCI compliance by the customer",
      "Sandbox access is fully self-serve; production card issuance requires program approval by Lithic",
      "Physical and tokenized cards available at Enterprise tier ($250K+ monthly volume); Starter tier is virtual-only",
      "Primary markets are US and Canada; other geographies not publicly confirmed"
    ]
  },
  "developer": {
    "docs_url": "https://docs.lithic.com/",
    "api_reference_url": "https://app.lithic.com/api/reference",
    "openapi_spec_url": null,
    "postman_collection_url": null,
    "changelog_url": null,
    "status_page_url": "https://status.lithic.com",
    "llms_txt_url": null,
    "markdown_docs_url": null,
    "rendering": "static"
  },
  "adoption": {
    "launched_at": "2020-01-01",
    "ga_date": "2021-01-01",
    "github_stars": null,
    "github_stars_at": null,
    "notable_customers": [
      "Mercury",
      "Novo",
      "Parker",
      "Giftly"
    ]
  },
  "scores": {
    "agent_friendliness": 40,
    "pricing_transparency": 60,
    "setup_speed": 75,
    "docs_quality": 35,
    "procurement_friction": 75,
    "trust_readiness": 70,
    "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 want to try it free before paying"
    ]
  },
  "sources": [
    {
      "field": "categories",
      "url": "https://www.lithic.com/card-issuing",
      "excerpt": "Lithic's platform enables rapid card program deployment with several core capabilities",
      "confidence": "high"
    },
    {
      "field": "pricing_model",
      "url": "https://research.contrary.com/company/lithic",
      "excerpt": "usage-based fees for things like creating virtual and physical cards, KYC, 3D Secure transaction authentications, etc., and interchange revenue",
      "confidence": "high"
    },
    {
      "field": "has_published_pricing",
      "url": "https://research.contrary.com/company/lithic",
      "excerpt": "Virtual cards: $0.10 per virtual card; 0.2% on the first $100K in volume and 0.4% on all volume thereafter",
      "confidence": "high"
    },
    {
      "field": "minimum_commitment",
      "url": "https://www.lithic.com/blog/introducing-lithic",
      "excerpt": "Create active cards for a few cents each, with no expensive monthly fees",
      "confidence": "high"
    },
    {
      "field": "self_serve_signup",
      "url": "https://app.lithic.com/signup",
      "excerpt": "You can sign up today and start moving money, with a self-serve platform where there is no need to talk to Sales or wade through lengthy MSAs to get started",
      "confidence": "high"
    },
    {
      "field": "requires_sales_call",
      "url": "https://app.lithic.com/signup",
      "excerpt": "You can sign up today and start moving money, with a self-serve platform where there is no need to talk to Sales",
      "confidence": "high"
    },
    {
      "field": "soc2",
      "url": "https://www.lithic.com/",
      "excerpt": "SOC 1 Type 1, SOC 2 Type 2, PCI DSS, ISO 27001",
      "confidence": "high"
    },
    {
      "field": "iso_27001",
      "url": "https://www.lithic.com/",
      "excerpt": "SOC 1 Type 1, SOC 2 Type 2, PCI DSS, ISO 27001",
      "confidence": "high"
    },
    {
      "field": "pci_dss",
      "url": "https://docs.lithic.com/docs/cards",
      "excerpt": "Due to PCI compliance requirements, the pan and cvv fields are only available in Production for clients who have verified PCI compliance",
      "confidence": "high"
    },
    {
      "field": "gdpr",
      "url": "https://trust.lithic.com/",
      "excerpt": "Lithic Trust Center — page exists but GDPR not listed among certifications shown",
      "confidence": "medium"
    },
    {
      "field": "documented_rate_limits",
      "url": "https://docs.lithic.com/docs/rate-limits",
      "excerpt": "Read operations: 30 RPS; Write operations: 5 RPS (Default Production Limits)",
      "confidence": "high"
    },
    {
      "field": "known_restrictions",
      "url": "https://research.contrary.com/company/lithic",
      "excerpt": "Processor Only — designed for customers who already have their own sponsor bank; clients keep the highest share of interchange revenue and have the lowest usage-based fees",
      "confidence": "high"
    },
    {
      "field": "input_types",
      "url": "https://www.lithic.com/card-issuing",
      "excerpt": "The platform accommodates debit, prepaid, charge, and revolving credit products",
      "confidence": "high"
    },
    {
      "field": "supported_regions",
      "url": "https://grow.lithic.com/canada",
      "excerpt": "Lithic has expanded into Canada to provide developer-first card issuing capabilities",
      "confidence": "medium"
    },
    {
      "field": "sandbox_available",
      "url": "https://docs.lithic.com/",
      "excerpt": "A safe environment mirroring production",
      "confidence": "high"
    },
    {
      "field": "sdk_languages",
      "url": "https://github.com/lithic-com",
      "excerpt": "Lithic provides SDKs for Node.js, Python, Java, Kotlin, Go, and Ruby. The organization also maintains Lithic OpenAPI 3.0 definitions",
      "confidence": "high"
    },
    {
      "field": "base_url",
      "url": "https://docs.lithic.com/docs/api-basics",
      "excerpt": "The API endpoint is `https://api.lithic.com/v1/`",
      "confidence": "high"
    },
    {
      "field": "auth_methods",
      "url": "https://docs.lithic.com/docs/api-basics",
      "excerpt": "Authentication uses a header format: `Authorization: YOUR_API_KEY`",
      "confidence": "high"
    },
    {
      "field": "api_style",
      "url": "https://docs.lithic.com/docs/api-basics",
      "excerpt": "Request bodies must be valid JSON with `Content-Type: application/json`",
      "confidence": "high"
    },
    {
      "field": "stability",
      "url": "https://docs.lithic.com/docs/api-basics",
      "excerpt": "Lithic makes backwards-compatible changes without notice, including adding optional parameters, new response fields, and new endpoints. Breaking changes require prior notification.",
      "confidence": "high"
    },
    {
      "field": "idempotency_supported",
      "url": "https://docs.lithic.com/docs/idempotent-requests",
      "excerpt": "Idempotency keys are valid for **30 days** for a given endpoint and HTTP method",
      "confidence": "high"
    },
    {
      "field": "webhook_signing",
      "url": "https://docs.lithic.com/docs/events-api",
      "excerpt": "Lithic uses **HMAC-SHA256** to authenticate webhooks. Each request includes three verification headers: `webhook-id`, `webhook-timestamp`, `webhook-signature`",
      "confidence": "high"
    },
    {
      "field": "webhook_events_url",
      "url": "https://docs.lithic.com/docs/events-api",
      "excerpt": "The documentation references a comprehensive listing at **[Types of Events](/docs/types-of-events)**",
      "confidence": "high"
    },
    {
      "field": "vendor_description",
      "url": "https://www.lithic.com/",
      "excerpt": "Programmable card issuing and money movement",
      "confidence": "high"
    },
    {
      "field": "categories",
      "url": "https://www.lithic.com/platform/accounts",
      "excerpt": "Lithic enables clients to manage payments and money movement with flexible ledgering and Direct-to-Fed ACH",
      "confidence": "high"
    },
    {
      "field": "pricing_model",
      "url": "https://www.lithic.com/blog/introducing-lithic",
      "excerpt": "Create active cards for a few cents each, with no expensive monthly fees",
      "confidence": "high"
    },
    {
      "field": "has_published_pricing",
      "url": "https://www.lithic.com/blog/introducing-lithic",
      "excerpt": "Create active cards for a few cents each, with no expensive monthly fees. When someone spends money, you'll earn back a percentage of interchange revenue generated by the merchant.",
      "confidence": "high"
    },
    {
      "field": "minimum_commitment",
      "url": "https://sourceforge.net/software/product/Lithic/",
      "excerpt": "Pricing is simple, with no expensive monthly fees",
      "confidence": "high"
    },
    {
      "field": "requires_sales_call",
      "url": "https://www.lithic.com/blog/introducing-lithic",
      "excerpt": "no need to talk to Sales or wade through lengthy MSAs to get started",
      "confidence": "high"
    },
    {
      "field": "enterprise_plan_available",
      "url": "https://research.contrary.com/company/lithic",
      "excerpt": "Enterprise Program — For companies with $250K+ in monthly payment volume. Supports physical and tokenized cards (plus virtual). Enterprise pricing is available",
      "confidence": "high"
    },
    {
      "field": "soc2",
      "url": "https://trust.lithic.com/",
      "excerpt": "Lithic's security program aligns with SOC 1, SOC 2, ISO 27001, and PCI DSS, ensuring rigorous controls, continuous monitoring, and independent audits",
      "confidence": "high"
    },
    {
      "field": "pci_dss",
      "url": "https://www.lithic.com/",
      "excerpt": "SOC 1 Type 1, SOC 2 Type 2, PCI DSS, ISO 27001",
      "confidence": "high"
    },
    {
      "field": "hipaa",
      "url": "https://trust.lithic.com/",
      "excerpt": "Lithic Trust Center — page exists but HIPAA not listed among certifications (SOC 1 Type 1, SOC 2 Type 2, PCI DSS, ISO 27001 are the certifications shown)",
      "confidence": "medium"
    },
    {
      "field": "sla_published",
      "url": "https://www.lithic.com/transaction-processing",
      "excerpt": "99.99% uptime with no scheduled downtime",
      "confidence": "high"
    },
    {
      "field": "known_restrictions",
      "url": "https://www.lithic.com/services/program-management",
      "excerpt": "Lithic manages your integration and onboarding with one of our trusted partner sponsor banks",
      "confidence": "high"
    },
    {
      "field": "mcp_server_available",
      "url": "https://docs.lithic.com/reference",
      "excerpt": "Lithic Developer API Model Context Protocol (MCP) server enables AI-powered code editors like Cursor and Windsurf, Claude Code, Gemini, and Codex, to interact directly with the Lithic API. The server URL is https://docs.lithic.com/mcp.",
      "confidence": "high"
    },
    {
      "field": "input_types",
      "url": "https://www.lithic.com/transaction-processing",
      "excerpt": "Lithic connects directly to the Visa, Mastercard, and Amex networks",
      "confidence": "high"
    },
    {
      "field": "webhooks_supported",
      "url": "https://docs.lithic.com/docs/events-api",
      "excerpt": "The Lithic Events API enables near-real-time notifications about platform activities. You can register webhook endpoints, manage subscriptions, retrieve historical events, and verify message authenticity through cryptographic signatures.",
      "confidence": "high"
    },
    {
      "field": "sandbox_available",
      "url": "https://app.lithic.com/signup",
      "excerpt": "You can sign up today and start moving money, with a self-serve platform where there is no need to talk to Sales",
      "confidence": "high"
    },
    {
      "field": "primary_use_cases",
      "url": "https://www.lithic.com/",
      "excerpt": "Disbursements and instant fund distribution, Fleet card programs, Expense management, Corporate incentives and rewards, Healthcare payments, Insurance payouts, Bill pay solutions, Agentic commerce with real-time payments",
      "confidence": "high"
    },
    {
      "field": "base_url",
      "url": "https://docs.lithic.com/docs/create-card",
      "excerpt": "For sandbox testing, requests go to: `https://sandbox.lithic.com/v1/cards`",
      "confidence": "high"
    },
    {
      "field": "auth_methods",
      "url": "https://docs.lithic.com/docs/create-card",
      "excerpt": "The API requires an authorization header with your API credentials passed as: `\"Authorization: {Sandbox API key}\"`",
      "confidence": "high"
    },
    {
      "field": "versioning_scheme",
      "url": "https://docs.lithic.com/docs/api-basics",
      "excerpt": "The API endpoint is `https://api.lithic.com/v1/`",
      "confidence": "high"
    },
    {
      "field": "idempotency_supported",
      "url": "https://docs.lithic.com/docs/idempotent-requests",
      "excerpt": "Include this header in POST requests: `Idempotency-Key: {key}`",
      "confidence": "high"
    },
    {
      "field": "error_format",
      "url": "https://docs.lithic.com/docs/api-basics",
      "excerpt": "Common HTTP status codes: 400 Invalid query parameter, 401 Authentication failure, 422 Authorization simulation failure, 429 Rate limit exceeded, 5xx Server-side errors",
      "confidence": "high"
    },
    {
      "field": "webhook_signing",
      "url": "https://docs.lithic.com/docs/events-api",
      "excerpt": "The signing process concatenates these elements: `\"${webhookId}.${webhookTimestamp}.${body}\"` separated by periods, then applies HMAC using your webhook secret's Base64 portion (after the `whsec_` prefix).",
      "confidence": "high"
    },
    {
      "field": "rate_limit_requests",
      "url": "https://docs.lithic.com/docs/rate-limits",
      "excerpt": "Read operations: 30 RPS; Write operations: 5 RPS (Default Production Limits)",
      "confidence": "high"
    },
    {
      "field": "rate_limit_window",
      "url": "https://docs.lithic.com/docs/rate-limits",
      "excerpt": "Rate Limit Window: Per second (RPS - requests per second)",
      "confidence": "high"
    },
    {
      "field": "rate_limit_requests",
      "url": "https://docs.lithic.com/docs/rate-limits",
      "excerpt": "Exceeded limits receive a 429 HTTP status code. Response includes `x-requests-remaining` header showing remaining capacity",
      "confidence": "high"
    },
    {
      "field": "requires_verification",
      "url": "https://docs.lithic.com/docs/get-api-key",
      "excerpt": "A Production API key becomes available only after you're approved and enabled for the production environment.",
      "confidence": "high"
    },
    {
      "field": "sdk_packages",
      "url": "https://github.com/lithic-com/lithic-java",
      "excerpt": "Maven coordinates: `com.lithic.api:lithic-java`. Gradle: `implementation(\"com.lithic.api:lithic-java:0.128.0\")`",
      "confidence": "high"
    },
    {
      "field": "sdk_packages",
      "url": "https://github.com/lithic-com/lithic-kotlin",
      "excerpt": "Maven coordinates: `com.lithic.api:lithic-kotlin`. Gradle: `implementation(\"com.lithic.api:lithic-kotlin:0.127.0\")`",
      "confidence": "high"
    },
    {
      "field": "mcp_url",
      "url": "https://docs.lithic.com/docs/welcome",
      "excerpt": "MCP Server integration option [listed among developer tools]",
      "confidence": "medium"
    },
    {
      "field": "launched_at",
      "url": "https://techcrunch.com/2021/05/20/privacy-com-rebrands-to-lithic-raises-43m-for-virtual-payment-cards/",
      "excerpt": "Privacy.com launched its new Card Issuing API in 2020 to give corporate customers the ability to create payment cards for their customers",
      "confidence": "high"
    },
    {
      "field": "notable_customers",
      "url": "https://www.lithic.com/fintech-partnerships/customers",
      "excerpt": "Mercury: 'Lithic has surpassed our product expectations, and has handled hundreds of millions of dollars of monthly volume without issue.' — Catherine Unertl, Head of FP&O, Mercury",
      "confidence": "high"
    },
    {
      "field": "notable_customers",
      "url": "https://www.lithic.com/fintech-partnerships/customers",
      "excerpt": "Companies like Mercury, Novo, and Parker use Lithic's platform to power their card programs",
      "confidence": "high"
    },
    {
      "field": "requires_verification",
      "url": "https://docs.lithic.com/docs/client-onboarding-guide",
      "excerpt": "You must not issue or otherwise distribute cards to any third parties unless and until Lithic has given you explicit approval in writing of all Program-related materials required to provide cards to third parties.",
      "confidence": "high"
    },
    {
      "field": "sdk_packages",
      "url": "https://github.com/lithic-com/lithic-ruby",
      "excerpt": "Gem: `gem \"lithic\", \"~> 0.16.0\"`. Ruby 3.2.0 or higher required.",
      "confidence": "high"
    },
    {
      "field": "mcp_url",
      "url": "https://docs.lithic.com/mcp",
      "excerpt": "This URL can only be accessed with a MCP client.",
      "confidence": "medium"
    },
    {
      "field": "quickstart_url",
      "url": "https://docs.lithic.com/docs/welcome",
      "excerpt": "Quickstart section covering: 1. Create a Card 2. Authorize a Transaction 3. View Transaction 4. Simulate Clearing 5. View a Transaction",
      "confidence": "high"
    },
    {
      "field": "ga_date",
      "url": "https://www.lithic.com/blog/introducing-lithic",
      "excerpt": "The article mentions the platform was 'initially launched...last summer' (relative to May 2021 publication), placing the initial launch around summer 2020. The formal rebrand and announcement of Lithic occurred on May 20, 2021.",
      "confidence": "medium"
    },
    {
      "field": "notable_customers",
      "url": "https://www.lithic.com/fintech-partnerships/customers",
      "excerpt": "Novo: 'I've had a great experience with the Lithic team. They truly desire Novo's success.' — Chelsye Toliver, Director of Payments, Novo",
      "confidence": "high"
    },
    {
      "field": "data_retention_policy_url",
      "url": "https://www.lithic.com/legal/privacy-policy",
      "excerpt": "Lithic may retain data about users for a period of time consistent with applicable law",
      "confidence": "medium"
    }
  ],
  "fields_not_found": [
    "pci_dss_level",
    "hipaa",
    "gdpr",
    "specific_enterprise_card_fees",
    "deprecation_policy_url",
    "sla_url",
    "starting_price_usd",
    "price_basis",
    "free_tier_limit",
    "ga_date_exact"
  ],
  "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/lithic",
        "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/lithic/{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"
      }
    ]
  }
}