List Recordings
In order to retrieve all recordings you can use this request.
GET
/workspaces/{workspaceId}/recordings
List recordings
Parámetros de consulta
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
Cuerpo de la respuesta
results
array of object
Mostrar atributos secundarios
results.id
string
obligatorio
The ID for the recording.
results.source
string
obligatorio
Possible values: call, conference
results.sourceId
string
obligatorio
The ID for the source.
results.channelId
string
The ID for the channel.
results.status
string
obligatorio
Possible values: accepted, completed, ongoing, paused, available, absent, failed
results.direction
string
Possible values: incoming, outgoing
results.originator
object
Mostrar atributos secundarios
results.originator.contact
object
Mostrar atributos secundarios
results.originator.contact.id
string
obligatorio
results.originator.contact.identifierKey
string
obligatorio
results.originator.contact.identifierValue
string
obligatorio
results.originator.number
object
obligatorio
Mostrar atributos secundarios
results.originator.number.type
string
obligatorio
Possible values: pstn, webrtc
results.originator.number.number
string
obligatorio
results.originator.number.anonymous
boolean
results.originator.number.callerIdName
string
results.originator.number.identity
string
results.originator.number.countryIsoCode
string
results.receiver
object
Mostrar atributos secundarios
results.receiver.contact
object
Mostrar atributos secundarios
results.receiver.contact.id
string
obligatorio
results.receiver.contact.identifierKey
string
obligatorio
results.receiver.contact.identifierValue
string
obligatorio
results.receiver.number
object
obligatorio
Mostrar atributos secundarios
results.receiver.number.type
string
obligatorio
Possible values: pstn, webrtc
results.receiver.number.number
string
obligatorio
results.receiver.number.anonymous
boolean
results.receiver.number.callerIdName
string
results.receiver.number.identity
string
results.receiver.number.countryIsoCode
string
results.origin
string
obligatorio
Possible values: call-command-record, call-command-record-call, create-call, bridge-call
results.duration
integer
results.stereo
boolean
obligatorio
results.format
string
obligatorio
results.transcription
boolean
obligatorio
results.conferenceId
string
The ID for the conference.
results.url
string
results.roomInfoUrl
string
results.createdAt
string
obligatorio
results.updatedAt
string
obligatorio
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.
Ejemplo de código
curl -X GET 'https://api.bird.com/workspaces/{workspaceId}/recordings' \
-H 'Authorization: AccessKey YOUR_ACCESS_KEY'Ejemplo de código
curl "/workspaces/{workpaceId}/recordings" \
-H 'Authorization: AccessKey YOUR_SECRET_TOKEN'
Ejemplo de código
{
"results": [
{
"id": "5b74ee9e-9d45-473a-82cd-f1f7feea6bbd",
"sourceId": "50fa2203-66c2-4820-864a-1a8002952f4e",
"channelId": "880d8171-cbab-47bb-81b6-b1a0902da136",
"originator": {
"number": {
"type": "pstn",
"number": "3197004499436",
"identity": "+3197004499436",
"countryIsoCode": "NL"
}
},
"receiver": {
"contact": {
"id": "225dcb7c-efbd-4288-b78d-93fba8743dd0",
"identifierKey": "phonenumber",
"identifierValue": "+351919150029"
},
"number": {
"type": "pstn",
"number": "351919150029",
"countryIsoCode": "PT"
}
},
"source": "call",
"direction": "outgoing",
"origin": "create-call",
"status": "available",
"duration": 29,
"format": "mp3",
"stereo": false,
"transcription": false,
"url": "https://regional--voice-recordings--637323691990--euw1.s3.eu-west-1.amazonaws.com/workspaceID%3A8bc02f53-87ac-48d2-b4fd-c2cf856a305f/sourceID%3A50fa2203-66c2-4820-864a-1a8002952f4e/5b74ee9e-9d45-473a-82cd-f1f7feea6bbd.mp3?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIAZIY3TY7LJ5FTXZNH%2F20231024%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20231024T192759Z&X-Amz-Expires=600&X-Amz-Security-Token=IQoJb3JpZ2luX2VjECMaCWV1LXdlc3QtMSJHMEUCICn7aCxvGiqRhraKX%2BYMxuXotSVXNhaYWL9QLFZObgzEAiEAs9JvMn%2FmD89hj0GMqMEIvyWtXAS%2FZ3N2SMqeG8n1vpsq7QMITBABGgw2MzczMjM2OTE5OTAiDPTgnFfpK8sIuKNDhirKA7W3WYuW2lc100QOlZwHqjabQMRTUym7FSUg6P7pICk1%2FjWS%2FzIJSQuzcke%2BfsEJZoHcoC7UAN8gW5SnfWZcMTq%2FeSpeAR8XWzW7fbF41gc8EeAJ6Jon0yFasS931L9n0jSSDrXcxvj4qHkLfbvTL5xfmxFqsZ86LyNRv1Jz2M7UCTiWRbZidA31Bpnr%2FRpArDd2jH7iPqsV8tnGGTqgXV7QoQT5hTmxuNCYmAc7qqWOb4xsj764eCCGRCexdmZVLHc6EpkDT2rGnmoaKaxg7QY9HVnk980pCwzAmLXGVOBOKenEf4VOve66nIiCXK%2FhWAThcPbuj8I4cCZxUc7KqmdA693RaY24F99WraNoBhEHowFKRWOrz78O2PHiz9ulDeHAQBYxKmptwqizuuNVi4dYiaB%2BErp0OvfQdu8A1W8DRwJnpbfbIP1Za1LSdH6%2FJMXy%2BfIOO%2FfE9S%2FExEHBUBXzZvOXFqKe4StxpUSq3y%2F2tNeQmisFo9fRBMF0FMJI8ovM94bFjlcTOYm6JwXoy%2BHq0ULuaEVhF5M3yBUV63zzungZBH%2BxAXwBHDY2qQUNmMHP7uhq%2BRmKuk9ijkKK2D7FqlbfPK7y0svsMNmg4KkGOqUBEookm2SQ2xZr3XEMrLeNVGQISomhQXcVn2oVS2F4Q8U3L%2FeO5fEwYus%2BYaNiZUbY2jG31qHoYLT%2BvonZSUfLZrilgPbKQvh2SXdtZFKDo%2BHdwYXt%2FZIomNXUXMZz1QflKHLSkzGwaCH7Ex9ECxPDgPjVqA25uPPsmlsti7qzlXvymHRFNvRn1fu%2F207PUCmro4ejXmjVPdMXr5FBsRChI2sZli8z&X-Amz-SignedHeaders=host&x-id=GetObject&X-Amz-Signature=9a32932db1a464460cb29efb55347b0725b0f73ca7303eb6fd194ddd32a5f0e4",
"createdAt": "2023-10-23T15:55:08.234Z",
"updatedAt": "2023-10-23T15:55:38.278Z",
"startedAt": "2023-10-23T15:55:08.121Z",
"endedAt": "2023-10-23T15:55:38.101Z"
}
]
}