Transcripts

Get conversation transcripts in multiple formats

Retrieves only the transcript for a conversation in various formats. This endpoint is optimized for transcript-only access without other conversation metadata.

Endpoint

GET https://api.ayra.ai/v1/conversations/{conversation_id}/transcript

Authentication

Requires API key with conversations:read permission.

Path Parameters

conversation_id(string, required) - The unique identifier of the conversation

Query Parameters

format(string) - Transcript format. Values: json, text, srt, vtt. Default: json

include_timestamps(boolean) - Include timing information (for text format). Default: true

include_sentiment(boolean) - Include per-message sentiment (for JSON format). Default: false

speaker_labels(boolean) - Include speaker labels. Default: true

Request Examples

JSON Format (Default):

curl https://api.ayra.ai/v1/conversations/conv_abc123xyz789/transcript \
  -H "Authorization: Bearer sk_live_abc123xyz789"

Plain Text Format:

curl "https://api.ayra.ai/v1/conversations/conv_abc123xyz789/transcript?format=text" \
  -H "Authorization: Bearer sk_live_abc123xyz789"

SRT Subtitle Format:

curl "https://api.ayra.ai/v1/conversations/conv_abc123xyz789/transcript?format=srt" \
  -H "Authorization: Bearer sk_live_abc123xyz789"

WebVTT Format:

curl "https://api.ayra.ai/v1/conversations/conv_abc123xyz789/transcript?format=vtt" \
  -H "Authorization: Bearer sk_live_abc123xyz789"

Response Formats

JSON Format (Default):

{
  "data": {
    "conversation_id": "conv_abc123xyz789",
    "language": "en",
    "word_count": 156,
    "messages": [
      {
        "id": "msg_001",
        "speaker": "agent",
        "text": "Thank you for calling...",
        "timestamp": 0,
        "duration": 4.2,
        "confidence": 0.98
      }
    ]
  }
}

Text Format:

[00:00:00] Agent: Thank you for calling Acme Corporation...

[00:00:05] Customer: Hi, I was charged twice...

Notes

•Transcripts are generated asynchronously after call completion, typically available within 30 seconds
•Confidence scores indicate transcription accuracy (0-1 scale)
•SRT and VTT formats are suitable for video overlay or accessibility purposes
•Text format is human-readable for quick review
•JSON format provides richest data for programmatic analysis

Ready to transform your agency?

Start building with Ayra today. No credit card required.