GET /v1/billing

Billing endpoints return current usage stats and available plan information.

GET /v1/billing/usage

Current period usage for the authenticated organization.

Authentication required — Authorization: Bearer ctv_key_…

GET /v1/billing/usage
Authorization: Bearer ctv_key_abc123

Response

{
  "plan": "starter",
  "billing_interval": "monthly",
  "signatures_used": 1243,
  "signatures_included": 5000,
  "overage_rate": 0.008,
  "overage_count": 0,
  "period_start": "2026-05-01T00:00:00.000Z",
  "period_end": "2026-05-31T23:59:59.999Z"
}

Field	Description
`plan`	Current plan: `free`, `starter`, `growth`, `scale`, `enterprise`
`billing_interval`	`monthly` or `annual`
`signatures_used`	Signatures consumed this billing period
`signatures_included`	Plan allowance (`null` for enterprise = unlimited)
`overage_rate`	Per-signature overage price (USD)
`overage_count`	Signatures beyond the included allowance
`period_start`	Start of current billing period (ISO 8601)
`period_end`	End of current billing period (ISO 8601)

GET /v1/billing/plans

Public plan catalogue. No authentication required.

GET /v1/billing/plans

Response

{
  "plans": [
    {
      "plan": "free",
      "label": "Free",
      "monthly_price": 0,
      "annual_monthly_price": 0,
      "annual_total": 0,
      "included_signatures": 500,
      "overage_rate": 0,
      "upgrade_url": "https://certivu.ai/pricing"
    },
    {
      "plan": "starter",
      "label": "Starter",
      "monthly_price": 49,
      "annual_monthly_price": 39,
      "annual_total": 468,
      "included_signatures": 5000,
      "overage_rate": 0.008,
      "upgrade_url": "https://certivu.ai/pricing"
    }
  ]
}

Quota enforcement

When the free tier (500 signatures/month) is exhausted, POST /v1/records returns 402:

{
  "error": "signature_limit_reached",
  "message": "Free tier limit of 500 signatures/month reached.",
  "upgrade_url": "https://certivu.ai/pricing",
  "limit": 500,
  "current": 500
}

Paid tiers (Starter, Growth, Scale) never block — signatures above the included allowance are counted as overage and billed at the plan’s overage rate at period end.

Enterprise plans have no quota and no overage.

See Pricing & Quotas for the full pricing breakdown.