HAhappyscribe
Conversations

Retrieve a conversation

Retrieves metadata about a specific conversation. To retrieve the transcript content, use Exports.

audio_url, video_url, and soundwave_url are signed URLs available once the media has been transcoded (state automatic_done); they expire after a short period, so fetch them fresh rather than caching.

Conversations produced by the notetaker bot include a meeting object with calendar-aware metadata; it is null for uploaded files.

get/conversations/{id}

Request

  • Base URL
    https://www.happyscribe.com/api/v1
  • Auth
    API key in header Authorization

Path parameters

idstring required
Example:e458099e7f8da14f9625854ba7b6a026917ad306

ID of the conversation.

Response

The conversation.

idstring

Unique identifier of the conversation.

namestring
created_atstring date-time
updated_atstring date-time
state'initial' | 'ingesting' | 'automatic_transcribing' | 'automatic_done' | 'aligning' | 'locked' | 'failed' | 'demo'

Current processing state:

  • initial — waiting to be processed
  • ingesting — media file is being ingested
  • automatic_transcribing — audio is being transcribed to text
  • automatic_done — finished and ready to export
  • aligning — text is being realigned with the audio
  • locked — locked due to insufficient credits
  • failed — file failed to process
  • demo — the initial demo file
sharing_enabledboolean

true when "Anyone with the link" is enabled.

public_urlstring nullable

Public, no-login URL to share when sharing_enabled is true; null while sharing is disabled.

languagestring

BCP-47 language code.

audio_length_in_secondsnumber
cost_in_centsinteger
refundedboolean
tagsstring[]
delivery_estimated_atstring date-time

Estimated delivery time. It can change over time.

failure_reasonstring nullable

Error code for the failure.

failure_messagestring nullable

User-friendly message explaining the failure root cause.

soundwave_urlstring nullable

Soundwave in BBC audiowaveform binary format. Available once the state is automatic_done.

audio_urlstring nullable

Short-lived signed URL to the transcoded MP3. Present once transcoded; fetch fresh rather than caching.

video_urlstring nullable

Short-lived signed URL to the transcoded MP4. Present for video conversations once transcoded.

Example response

{
  "id": "e458099e7f8da14f9625854ba7b6a026917ad306",
  "name": "interview1.mov",
  "folder": {
    "id": 521,
    "name": "Marketing interviews"
  },
  "created_at": "2024-10-29T14:31:29.799Z",
  "updated_at": "2024-10-29T14:31:38.495Z",
  "state": "automatic_done",
  "sharing_enabled": false,
  "language": "en-GB",
  "audio_length_in_seconds": 42,
  "cost_in_cents": 100,
  "refunded": false,
  "tags": [
    "To do",
    "req_1234"
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.