List recordings
GET
/recordings
Query recordings by metadata filters or by most recent. Multiple filters are combined with AND logic.
Authorizations
Private API Key
Bearer token for authentication. Use your private API key as the token.
Parameters
Query Parameters
metadata
Filter recordings by metadata key-value pairs. Use metadata[key]=value syntax (URL-encode keys and values with encodeURIComponent). eg. metadata[userId]=user-123&metadata[plan]=pro
Type
object
Example
{
"userId": "user-123",
"plan": "pro"
}limit
Maximum number of results to return (1-100, default: 50)
Type
string
Example
"50"offset
Number of results to skip (default: 0)
Type
string
Example
"0"includeSignedUrls
Include presigned event URLs in the response.
Type
boolean
Example
trueResponses
Successfully retrieved recordings
application/json
JSON "recordings": [ { "recordingId": "550e8400-e29b-41d4-a716-446655440000", "timestamp": 1234567890, "links": { "self": "/recordings/550e8400-e29b-41d4-a716-446655440000", "events": "/recordings/550e8400-e29b-41d4-a716-446655440000/events", "eventsSigned": "/recordings/550e8400-e29b-41d4-a716-446655440000/events?expires=1735689600&keyId=key-2024-12&signature=a1b2c3d4e5f6..." }, "metadata": { "additionalProperties": "string" } } ]
{
}