Retrieve a transcript

Retrieves what each side said on one call.

GET/v1/actions/{action_id}/calls/{call_id}/transcript

Path parameters

action_idstringRequired
Starts with act_.
call_idstringRequired
Starts with call_.

Returns

The transcript. A call with no transcript yet has no turns.

call_idstring
The call. Starts with call_.
turnsarray of objects
What each side said, in order.
speakerenum
Possible values
veneVene.
placeThe pharmacy or office.
textstring
offset_msinteger
Milliseconds from the start of the call.

Errors

401unauthorized
The API key is missing, unknown, or revoked.
403forbidden
The key lacks the scope.
404not_found
No such action or call for this key.
429rate_limited
Over a limit. Wait for Retry-After.
500internal_error
A Vene fault.

curl https://api.venehealth.com/v1/actions/<action_id>/calls/<call_id>/transcript \
  -H "Authorization: Bearer <api_key>"

const response = await fetch('https://api.venehealth.com/v1/actions/<action_id>/calls/<call_id>/transcript', {
  headers: {
    Authorization: 'Bearer <api_key>',
  },
})
const result = await response.json()

{
  "call_id": "<call_id>",
  "turns": [
    {
      "speaker": "place",
      "text": "CVS Pharmacy, this is Dan.",
      "offset_ms": 1200
    },
    {
      "speaker": "vene",
      "text": "Hi Dan, I'm Jane Doe's patient AI advocate, calling to check whether her lisinopril is ready.",
      "offset_ms": 3400
    },
    {
      "speaker": "place",
      "text": "Can I get her date of birth?",
      "offset_ms": 9800
    }
  ]
}

{
  "error": {
    "code": "unauthorized",
    "message": "A valid API key is required"
  }
}

{
  "error": {
    "code": "forbidden",
    "message": "This key lacks access to this request"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Action not found"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "The Vene API is not configured here"
  }
}