DocumentatieEngagement Platform API
Sign inGet started
Guides
API

List Recordings

In order to retrieve all recordings you can use this request.
GET
/workspaces/{workspaceId}/recordings
List recordings
Queryparameters
limit
integer
Limits the number of results to return.
pageToken
string
The cursor that keeps track of the current position in the results.
sourceId
string
channelId
string
id
string
direction
string
Direction of the call
Possible values: incoming, outgoing
startAt
string
Start date for the query
endAt
string
End date for the query
from
string
From number of the call
to
string
To number of the call
status
string
Possible values: accepted, completed, ongoing, paused, available, absent, failed
Antwoord-payload
results
array of object
Onderliggende attributen tonen
results.id
string
verplicht
The ID for the recording.
results.source
string
verplicht
Possible values: call, conference
results.sourceId
string
verplicht
The ID for the source.
results.channelId
string
The ID for the channel.
results.status
string
verplicht
Possible values: accepted, completed, ongoing, paused, available, absent, failed
results.direction
string
Possible values: incoming, outgoing
results.originator
object
Onderliggende attributen tonen
results.originator.contact
object
Onderliggende attributen tonen
results.originator.contact.id
string
verplicht
results.originator.contact.identifierKey
string
verplicht
results.originator.contact.identifierValue
string
verplicht
results.originator.number
object
verplicht
Onderliggende attributen tonen
results.originator.number.type
string
verplicht
Possible values: pstn, webrtc
results.originator.number.number
string
verplicht
results.originator.number.anonymous
boolean
results.originator.number.callerIdName
string
results.originator.number.identity
string
results.originator.number.countryIsoCode
string
results.receiver
object
Onderliggende attributen tonen
results.receiver.contact
object
Onderliggende attributen tonen
results.receiver.contact.id
string
verplicht
results.receiver.contact.identifierKey
string
verplicht
results.receiver.contact.identifierValue
string
verplicht
results.receiver.number
object
verplicht
Onderliggende attributen tonen
results.receiver.number.type
string
verplicht
Possible values: pstn, webrtc
results.receiver.number.number
string
verplicht
results.receiver.number.anonymous
boolean
results.receiver.number.callerIdName
string
results.receiver.number.identity
string
results.receiver.number.countryIsoCode
string
results.origin
string
verplicht
Possible values: call-command-record, call-command-record-call, create-call, bridge-call
results.duration
integer
results.stereo
boolean
verplicht
results.format
string
verplicht
results.transcription
boolean
verplicht
results.conferenceId
string
The ID for the conference.
results.url
string
results.roomInfoUrl
string
results.createdAt
string
verplicht
results.updatedAt
string
verplicht
results.endedAt
string
results.startedAt
string
nextPageToken
string
The token that can be passed as pageToken in URL to retrieve the next set of results. If missing, no more results to display.
Codevoorbeeld
curl -X GET 'https://api.bird.com/workspaces/{workspaceId}/recordings' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'
Codevoorbeeld
curl "/workspaces/{workpaceId}/recordings" \
     -H 'Authorization: AccessKey YOUR_SECRET_TOKEN'