Skip to main content

Documentation Index

Fetch the complete documentation index at: https://partner-docs.contro.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
v1.1.0 - May 2026

​
Added

  • PATCH /partner/cards/{id}/limits now accepts a spendControl body with per-transaction-type velocity caps (sales, cash) across perTransaction, daily, monthly, and allTime horizons. See the Spend control guide.
  • Card object exposes a spendControl field summarising caps and (where the card program reports it) accrued spend.

​
Deprecated

  • The legacy body { "limit": <number|null> } on PATCH /partner/cards/{id}/limits continues to work for one release. It is mapped to { "spendControl": { "sales": { "allTime": <n> }, "cash": { "allTime": <n> } } }. The top-level limit field on the card object is now derived from spendControl.sales.allTime and is marked deprecated.

​
v1.0.0 - March 2026

Initial release of the Contro Partner API.

​
Endpoints

  • Card Programs - list and retrieve available card programs
  • Cardholders - create, list, get, update cardholders with KYC initiation and status
  • Cards - issue, activate, freeze, unfreeze, cancel cards with spending limit management and transaction history
  • Balance - check partner balance and list balance transactions
  • Webhooks - configure webhook URL/secret/events, list delivery events, retry failed deliveries
  • Usage & Billing - usage summaries and detailed records by billing period

​
Features

  • API key authentication via x-contro-api-key header with sandbox (sk_test_*) and production (sk_live_*) keys
  • Cursor-based pagination across all list endpoints
  • HMAC-SHA256 webhook signature verification
  • Rate limiting at 1,000 requests per minute
  • Consistent error format across all endpoints