List Recordings
In order to retrieve all recordings you can use this request.
GET
/workspaces/{workspaceId}/recordings
List recordings
Parametri di query
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
Payload della risposta
results
array of object
Mostra attributi secondari
results.id
string
obbligatorio
The ID for the recording.
results.source
string
obbligatorio
Possible values: call, conference
results.sourceId
string
obbligatorio
The ID for the source.
results.channelId
string
The ID for the channel.
results.status
string
obbligatorio
Possible values: accepted, completed, ongoing, paused, available, absent, failed
results.direction
string
Possible values: incoming, outgoing
results.originator
object
Mostra attributi secondari
results.originator.contact
object
Mostra attributi secondari
results.originator.contact.id
string
obbligatorio
results.originator.contact.identifierKey
string
obbligatorio
results.originator.contact.identifierValue
string
obbligatorio
results.originator.number
object
obbligatorio
Mostra attributi secondari
results.originator.number.type
string
obbligatorio
Possible values: pstn, webrtc
results.originator.number.number
string
obbligatorio
results.originator.number.anonymous
boolean
results.originator.number.callerIdName
string
results.originator.number.identity
string
results.originator.number.countryIsoCode
string
results.receiver
object
Mostra attributi secondari
results.receiver.contact
object
Mostra attributi secondari
results.receiver.contact.id
string
obbligatorio
results.receiver.contact.identifierKey
string
obbligatorio
results.receiver.contact.identifierValue
string
obbligatorio
results.receiver.number
object
obbligatorio
Mostra attributi secondari
results.receiver.number.type
string
obbligatorio
Possible values: pstn, webrtc
results.receiver.number.number
string
obbligatorio
results.receiver.number.anonymous
boolean
results.receiver.number.callerIdName
string
results.receiver.number.identity
string
results.receiver.number.countryIsoCode
string
results.origin
string
obbligatorio
Possible values: call-command-record, call-command-record-call, create-call, bridge-call
results.duration
integer
results.stereo
boolean
obbligatorio
results.format
string
obbligatorio
results.transcription
boolean
obbligatorio
results.conferenceId
string
The ID for the conference.
results.url
string
results.roomInfoUrl
string
results.createdAt
string
obbligatorio
results.updatedAt
string
obbligatorio
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.
Esempio di codice
curl -X GET 'https://api.bird.com/workspaces/{workspaceId}/recordings' \
-H 'Authorization: AccessKey YOUR_ACCESS_KEY'Esempio di codice
curl "/workspaces/{workpaceId}/recordings" \
-H 'Authorization: AccessKey YOUR_SECRET_TOKEN'
Esempio di codice
{
"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"
}
]
}