Skip to main content

​
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