SDK Overview

While the IdentityCall API can be accessed directly via HTTP requests, we provide client libraries and code examples for popular programming languages to make integration easier.

Available Languages

Quick Comparison

Installation

pip install requests
# Optional for async support
pip install aiohttp

npm install node-fetch form-data
# Or with TypeScript
npm install node-fetch form-data @types/node-fetch

composer require guzzlehttp/guzzle

gem install httparty multipart-post

Common Patterns

All our SDK examples follow these patterns:

1. Environment-Based Configuration

API keys are read from environment variables:

export IDENTITYCALL_API_KEY="idc_your_api_key_here"

2. Consistent Error Handling

All clients raise/throw specific exceptions for different error types:

• AuthenticationError - Invalid or missing API key
• PermissionError - Insufficient permissions
• NotFoundError - Resource doesn’t exist
• ValidationError - Invalid request data
• RateLimitError - Too many requests
• APIError - General server errors

3. Automatic Retry

Built-in retry logic for transient failures:

• Rate limit errors (429): Wait for retry_after header
• Server errors (5xx): Exponential backoff

4. Resource-Oriented Design

Each client follows a consistent structure:

client.recordings.list()
client.recordings.create()
client.recordings.get(id)
client.recordings.update(id)
client.recordings.delete(id)
client.recordings.transcription(id)
client.recordings.results(id)
client.recordings.summary(id)

Getting Started

1. Get your API key from the IdentityCall dashboard 
2. Choose your language and follow the installation instructions
3. Set your environment variable with your API key
4. Start making requests using the code examples

Next Steps