Authentication

All API requests require a Bearer token in the Authorization header. API keys are managed in Agency Settings (Enterprise tier).

Authorization: Bearer ibc_prod_xxxxxxxxxxxxxxxx

Rate Limiting

API endpoints are rate limited to 100 requests per minute per agency. When exceeded, you'll receive a 429 response with a retry_after field.

Endpoints

GET/api/v1/clients

Returns paginated list of clients for your agency.

Parameters

pageintegerPage number (default: 1)

limitintegerResults per page (max: 100, default: 25)

Response

{ "clients": [{ "id": "uuid", "first_name": "Karen", "last_name": "H.", "email": "...", "status": "active", "coverage_type": "medicare" }], "total": 32, "page": 1, "hasMore": true }

Rate limit: 100 requests/minute

GET/api/v1/proposals

Returns paginated list of proposals.

Parameters

pageintegerPage number

limitintegerResults per page (max: 50)

Response

{ "proposals": [{ "id": "uuid", "status": "sent", "coverage_type": "medicare", "county": "Maricopa", "share_slug": "abc123" }], "page": 1 }

Rate limit: 100 requests/minute

GET/api/v1/agents

Returns list of agents in your agency.

Response

{ "agents": [{ "id": 1, "first_name": "Mike", "last_name": "Jones", "role": "agent", "profile_slug": "mike-jones" }] }

Rate limit: 100 requests/minute

Your Agency API · Need help? Contact us at support@ibcplatform.com