> ## Documentation Index > Fetch the complete documentation index at: https://docs.sully.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get Audio Transcription > Retrieve a transcription by ID. Returns the current status and results if processing is complete. The transcription result includes: - Full transcript text - Word-level timestamps - Speaker diarization (when multiple speakers detected) - Confidence scores ## OpenAPI ````yaml GET /v2/audio/transcriptions/{id} openapi: 3.1.0 info: title: Sully API description: > The Sully API is a robust platform designed to empower healthcare technology companies and Electronic Health Record (EHR) vendors by integrating advanced AI-driven clinical capabilities to help save healthcare providers (HCPs) time and make better decisions. ## V2 Audio Transcriptions The V2 Audio Transcriptions API provides enhanced audio transcription services using advanced AI models with improved accuracy and language support. ### Authentication The API uses API key authentication. You must include both: - `X-API-Key`: Your API key - `X-Account-Id`: Your account identifier ### Rate Limiting The API implements rate limiting to ensure fair usage. Rate limit information is returned in response headers: - `X-RateLimit-Limit`: Maximum requests allowed - `X-RateLimit-Remaining`: Remaining requests in current window - `X-RateLimit-Reset`: When the rate limit resets ### Audio File Support Supported audio formats: - WAV (audio/wav, audio/wave, audio/x-wav) - MP3 (audio/mpeg, audio/mp3) - FLAC (audio/flac) - OGG (audio/ogg) - WebM (audio/webm) - MP4 (audio/mp4) - M4A (audio/m4a) - AAC (audio/aac) - Opus (audio/opus) Maximum file size: 100MB ### Language Support The API supports multiple languages, including: - English (en, en-US) with medical-optimized transcription - Spanish (es), German (de), French (fr), Hindi (hi), Italian (it), Japanese (ja), Dutch (nl), Portuguese (pt), and Russian (ru) - Additional support for languages including Chinese, Korean, and others ### Processing V2 Transcriptions are processed asynchronously: 1. Upload returns immediately with `pending` status 2. Processing happens in the background 3. Status updates to `processing`, then `completed` or `failed` 4. Webhook notifications are sent when processing completes (if configured) ### Dictation V2 transcriptions support an optional `dictation` boolean field. When enabled, the transcript is formatted for dictation-style output. The default is `false`. version: 0.2.0 servers: - url: https://api.sully.ai description: Sully Production API - url: https://api-testing.sully.ai description: Sully Testing API security: - apiKeyAuth: [] accountIdAuth: [] tags: - name: Notes description: >- Operations for creating and managing clinical notes from medical encounters - name: Note Styles description: Operations for managing templates and formatting styles for clinical notes - name: Audio Transcriptions description: >- Operations for converting medical audio to text, including streaming capability - name: V2 Transcriptions description: > V2 Audio transcription operations with enhanced features The V2 Transcriptions API allows you to convert audio files to text using advanced AI models. Features include: - Multi-language support with specialized medical models - Speaker diarization (identifying different speakers) - Word-level timestamps and confidence scores - Automatic audio format conversion - Optional dictation-oriented transcript formatting - Asynchronous processing with webhook notifications - name: Utilities description: Utility operations for transforming and processing medical data - name: Codings description: >- Operations for medical coding analysis including ICD-10 and CPT code extraction - name: Macros description: >- Operations for detecting and expanding text macros in medical documentation paths: /v2/audio/transcriptions/{id}: get: tags: - V2 Transcriptions summary: Get transcription description: > Retrieve a transcription by ID. Returns the current status and results if processing is complete. The transcription result includes: - Full transcript text - Word-level timestamps - Speaker diarization (when multiple speakers detected) - Confidence scores operationId: getV2Transcription parameters: - name: id in: path required: true description: Transcription ID schema: type: string pattern: ^tr_[a-zA-Z0-9]+$ example: tr_abc123def456 responses: '200': description: Transcription retrieved successfully content: application/json: schema: $ref: '#/components/schemas/V2TranscriptionResponse' examples: pending_transcription: summary: Transcription still processing value: data: id: tr_abc123def456 status: processing created_at: '2024-01-15T10:30:00Z' updated_at: '2024-01-15T10:30:15Z' completed_transcription: summary: Completed transcription with results value: data: id: tr_abc123def456 status: completed result: channels: - transcript: >- Hello, this is a test transcription with multiple speakers. confidence: 0.95 words: - word: Hello start: 0 end: 0.5 confidence: 0.98 speaker: 0 - word: this start: 0.6 end: 0.8 confidence: 0.97 speaker: 0 - word: is start: 0.9 end: 1 confidence: 0.96 speaker: 0 created_at: '2024-01-15T10:30:00Z' updated_at: '2024-01-15T10:32:30Z' failed_transcription: summary: Failed transcription value: data: id: tr_abc123def456 status: failed result: error: Error processing transcription created_at: '2024-01-15T10:30:00Z' updated_at: '2024-01-15T10:31:45Z' '400': $ref: '#/components/responses/V2BadRequest' '401': $ref: '#/components/responses/V2Unauthorized' '404': $ref: '#/components/responses/V2NotFound' '429': $ref: '#/components/responses/V2RateLimitExceeded' '500': $ref: '#/components/responses/V2InternalServerError' components: schemas: V2TranscriptionResponse: type: object properties: data: $ref: '#/components/schemas/V2Transcription' required: - data V2Transcription: type: object properties: id: type: string pattern: ^tr_[a-zA-Z0-9]+$ description: Unique transcription identifier example: tr_abc123def456 status: $ref: '#/components/schemas/V2TranscriptionStatus' result: $ref: '#/components/schemas/V2TranscriptionResult' created_at: type: string format: date-time description: When the transcription was created example: '2024-01-15T10:30:00Z' updated_at: type: string format: date-time description: When the transcription was last updated example: '2024-01-15T10:32:30Z' required: - id - status - created_at - updated_at V2Error: type: object properties: error: type: string description: Error message example: Invalid request data details: type: object description: Additional error details (for validation errors) additionalProperties: true required: - error V2RateLimitError: type: object properties: error: type: object properties: code: type: string enum: - RATE_LIMIT_EXCEEDED example: RATE_LIMIT_EXCEEDED message: type: string example: Rate limit exceeded required: - code - message required: - error V2TranscriptionStatus: type: string enum: - pending - processing - completed - failed description: | Current status of the transcription: - `pending`: Transcription has been queued but not started - `processing`: Transcription is currently being processed - `completed`: Transcription completed successfully - `failed`: Transcription failed due to an error V2TranscriptionResult: type: object properties: channels: type: array items: $ref: '#/components/schemas/V2TranscriptionChannel' description: Transcription results per audio channel error: type: string description: Error message if transcription failed example: Error processing transcription description: > Transcription results. Contains either successful transcription data or error information. V2TranscriptionChannel: type: object properties: transcript: type: string description: Full transcript text for this channel example: Hello, this is a test transcription with multiple speakers. confidence: type: number format: float minimum: 0 maximum: 1 description: Overall confidence score for this channel example: 0.95 words: type: array items: $ref: '#/components/schemas/V2TranscriptionWord' description: Word-level timestamps and confidence scores required: - transcript - confidence V2TranscriptionWord: type: object properties: word: type: string description: The transcribed word example: Hello start: type: number format: float description: Start time in seconds example: 0 end: type: number format: float description: End time in seconds example: 0.5 confidence: type: number format: float minimum: 0 maximum: 1 description: Confidence score for this word example: 0.98 speaker: type: integer description: Speaker ID (when diarization is enabled) example: 0 required: - word - start - end - confidence responses: V2BadRequest: description: Bad request - invalid input content: application/json: schema: $ref: '#/components/schemas/V2Error' examples: missing_file: summary: Missing audio file value: error: No audio file provided invalid_file_type: summary: Unsupported file type value: error: 'Unsupported file type: text/plain' V2Unauthorized: description: Unauthorized - missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/V2Error' examples: missing_credentials: summary: Missing API credentials value: error: Missing API key or Account ID invalid_api_key: summary: Invalid API key value: error: Invalid API key V2NotFound: description: Resource not found content: application/json: schema: $ref: '#/components/schemas/V2Error' examples: transcription_not_found: summary: Transcription not found value: error: Transcription not found V2RateLimitExceeded: description: Rate limit exceeded headers: X-RateLimit-Limit: description: Maximum requests allowed schema: type: integer example: 100 X-RateLimit-Remaining: description: Remaining requests in current window schema: type: integer example: 0 X-RateLimit-Reset: description: When the rate limit resets schema: type: string format: date-time example: '2024-01-15T11:00:00Z' Retry-After: description: Seconds to wait before retrying schema: type: integer example: 60 content: application/json: schema: $ref: '#/components/schemas/V2RateLimitError' V2InternalServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/V2Error' examples: server_error: summary: Generic server error value: error: Internal Server Error securitySchemes: apiKeyAuth: type: apiKey in: header name: X-API-KEY accountIdAuth: type: apiKey in: header name: X-ACCOUNT-ID ````