Partner API reference

​

Base URL

https://api.contro.me/v1

​

Authentication

x-contro-api-key: sk_live_...

​

Request format

• All request bodies must be JSON with Content-Type: application/json
• Path parameters are denoted by {id} in endpoint paths
• Query parameters are used for filtering and pagination

​

Response format

{
  "id": "ch_abc123",
  "firstName": "Jane",
  "lastName": "Doe",
  "email": "jane@example.com",
  "status": "active"
}

{
  "data": [...],
  "page": 1,
  "limit": 20,
  "total": 137
}

​

Pagination

​

Rate limiting

• Response status: 429 Too Many Requests
• The Retry-After header indicates seconds to wait before retrying

​

Errors

{
  "success": false,
  "error": "Human-readable error message"
}

​

Resources