API Reference

The IdentityCall API is organized around REST. Our API accepts JSON request bodies, returns JSON responses, and uses standard HTTP response codes.

Base URL

All API requests should be made to:

https://api.identitycall.com/api/v1/public

Authentication

The API uses Bearer token authentication. Include your API key in the Authorization header:

Authorization: Bearer idc_your_api_key

See Authentication for details on creating and managing API keys.

Content Types

All requests that include a body should use:

• multipart/form-data for file uploads
• application/json for JSON data

All responses are returned as application/json.

Endpoints

Recordings

Pagination

List endpoints return paginated results. Use these query parameters:

Response format:

{
  "data": [...],
  "meta": {
    "current_page": 1,
    "total_pages": 5,
    "total_count": 100,
    "per_page": 20
  }
}

Rate Limiting

API requests are rate limited based on your plan:

When rate limited, you’ll receive a 429 Too Many Requests response with a Retry-After header.

Error Handling

The API uses standard HTTP status codes:

Error responses include a message:

{
  "error": "Description of what went wrong"
}

See Errors for detailed error handling guidance.