latestOpenAPI 3.1.1Proprietary – Contact us for usage terms2026-08-20173183551.4 KB

9da73dd2f99e

transcriptions

Get a single transcription by call ID

Retrieves a single transcription by its Call ID.

Permission: This endpoint is not governed by API token permissions. Your team must have the transcription feature enabled in its plan.

Monitoring: No impact.

For the returned transcription, in the items of the array of the <em>transcription_data.speeches</em> field, the field <em>channelId</em> takes one of the following values:

  • <em>1</em> for the caller emitting the call
  • <em>0</em> for the callee receiving the call

If the call is received by a Ringover user while the call is emitted by a call member that is not a registered contact, the <em>contact</em> field will be <em>null</em>.

get/transcriptions/{callId}

Path parameters

callIdstring required

The identifier of the call

Response

Successful operation — returns the transcription for the specified call.

idinteger
team_idinteger
user_idinteger
standard_idinteger nullable
cdr_idinteger
call_idstring
channel_idstring
providerstring
transcription_statusstring
creation_datestring date-time

Example response

[
  {
    "id": 88,
    "team_id": 16804,
    "user_id": 50907,
    "cdr_id": 991367,
    "call_id": "11322631031026875934",
    "channel_id": "17857850318647956376",
    "provider": "SPEECH_CALLITY",
    "user": {
      "user_id": 123456,
      "team_id": 123456,
      "initial": "PM",
      "color": "3CC8C8",
      "firstname": "Pauline",
      "lastname": "Martin",
      "company": "Ringover",
      "email": "pauline.martin@ringover.com",
      "picture": "https://cdn77.ringover.com/img/users/default.jpg",
      "concat_name": "Pauline Martin"
    },
    "contact": {
      "contact_id": 654321,
      "is_shared": true,
      "social_service_id": "00P7U000015Ei75YBX",
      "firstname": "John",
      "lastname": "Do",
      "company": "DoeCompany",
      "concat_name": "John Doe",
      "color": "3CC8C8",
      "initial": "JD",
      "creation_date": "2018-08-12T12:12:40.53Z",
      "numbers": [
        331797500010
      ]
    },
    "transcription_status": "DONE",
    "creation_date": "2018-06-12T23:23:40.99Z"
  }
]