API Overview

Base URL

All API requests should be made to:

https://app.transcord.app/api/v1

Authentication

Include your API key in the Authorization header:

Authorization: Bearer tr_live_your_api_key

See Authentication for details on getting and managing API keys.

Endpoints

Account

Method	Endpoint	Description
GET	`/v1/me`	Get current user and subscription info
PUT	`/v1/me`	Update user settings (name, timezone)
GET	`/v1/subscription`	Get detailed subscription and usage info
GET	`/v1/plans`	List available subscription plans
GET	`/v1/timezones`	List supported timezones

Calls

Method	Endpoint	Description
POST	`/v1/calls`	Initiate a recorded call
GET	`/v1/calls`	List recent calls

Recordings

Method	Endpoint	Description
GET	`/v1/recordings`	List all recordings
GET	`/v1/recordings/:id`	Get a single recording with transcript
DELETE	`/v1/recordings/:id`	Delete a recording
GET	`/v1/recordings/:id/transcript`	Get transcript in various formats
GET	`/v1/recordings/:id/audio`	Get audio file URL
GET	`/v1/recordings/:id/export`	Export transcript as Word document
GET	`/v1/recordings/search`	Full-text search in transcripts

Response Format

All responses are JSON with consistent structure:

Success Response

{
  "data": [...],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 100,
    "totalPages": 5,
    "hasMore": true
  }
}

Error Response

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

HTTP Status Codes

Code	Meaning
`200`	Success
`202`	Accepted - Resource is still processing
`400`	Bad Request - Invalid parameters
`401`	Unauthorized - Invalid or missing API key
`403`	Forbidden - Valid key but no access to resource
`404`	Not Found - Resource doesn’t exist
`429`	Too Many Requests - Rate limit exceeded
`500`	Internal Server Error

Rate Limits

100 requests per minute per API key
Rate limit headers are included in responses:
- X-RateLimit-Limit: Maximum requests per window
- X-RateLimit-Remaining: Requests remaining
- X-RateLimit-Reset: Unix timestamp when limit resets

Pagination

List endpoints support pagination with these parameters:

Parameter	Type	Default	Description
`page`	integer	1	Page number (1-indexed)
`limit`	integer	20	Results per page (max 100)

Response includes pagination info:

{
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 47,
    "totalPages": 3,
    "hasMore": true
  }
}

Overview

Transcord

Guides

Account

Calls

Recordings

API Overview

Base URL

Authentication

Endpoints

Account

Calls

Recordings

Response Format

Success Response

Error Response

HTTP Status Codes

Rate Limits

​Base URL

​Authentication

​Endpoints

​Account

​Calls

​Recordings

​Response Format

​Success Response

​Error Response

​HTTP Status Codes

​Rate Limits

​Pagination

Base URL

Authentication

Endpoints

Account

Calls

Recordings

Response Format

Success Response

Error Response

HTTP Status Codes

Rate Limits

Pagination