List Recordings
In order to retrieve all recordings you can use this request.
GET
/workspaces/{workspaceId}/recordings
List recordings
Parametry zapytania
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
Treść odpowiedzi
results
array of object
Pokaż atrybuty podrzędne
results.id
string
wymagane
The ID for the recording.
results.source
string
wymagane
Possible values: call, conference
results.sourceId
string
wymagane
The ID for the source.
results.channelId
string
The ID for the channel.
results.status
string
wymagane
Possible values: accepted, completed, ongoing, paused, available, absent, failed
results.direction
string
Possible values: incoming, outgoing
results.originator
object
Pokaż atrybuty podrzędne
results.originator.contact
object
Pokaż atrybuty podrzędne
results.originator.contact.id
string
wymagane
results.originator.contact.identifierKey
string
wymagane
results.originator.contact.identifierValue
string
wymagane
results.originator.number
object
wymagane
Pokaż atrybuty podrzędne
results.originator.number.type
string
wymagane
Possible values: pstn, webrtc
results.originator.number.number
string
wymagane
results.originator.number.anonymous
boolean
results.originator.number.callerIdName
string
results.originator.number.identity
string
results.originator.number.countryIsoCode
string
results.receiver
object
Pokaż atrybuty podrzędne
results.receiver.contact
object
Pokaż atrybuty podrzędne
results.receiver.contact.id
string
wymagane
results.receiver.contact.identifierKey
string
wymagane
results.receiver.contact.identifierValue
string
wymagane
results.receiver.number
object
wymagane
Pokaż atrybuty podrzędne
results.receiver.number.type
string
wymagane
Possible values: pstn, webrtc
results.receiver.number.number
string
wymagane
results.receiver.number.anonymous
boolean
results.receiver.number.callerIdName
string
results.receiver.number.identity
string
results.receiver.number.countryIsoCode
string
results.origin
string
wymagane
Possible values: call-command-record, call-command-record-call, create-call, bridge-call
results.duration
integer
results.stereo
boolean
wymagane
results.format
string
wymagane
results.transcription
boolean
wymagane
results.conferenceId
string
The ID for the conference.
results.url
string
results.roomInfoUrl
string
results.createdAt
string
wymagane
results.updatedAt
string
wymagane
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.
Przykład kodu
curl -X GET 'https://api.bird.com/workspaces/{workspaceId}/recordings' \
-H 'Authorization: AccessKey YOUR_ACCESS_KEY'Przykład kodu
curl "/workspaces/{workpaceId}/recordings" \
-H 'Authorization: AccessKey YOUR_SECRET_TOKEN'
Przykład kodu
{
"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"
}
]
}