Skip to content

List voicemails

GET
/v1/studios/{studio}/voicemails
curl --request GET \
--url 'https://api.caller9.app/v1/studios/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/voicemails?limit=50' \
--header 'Authorization: Bearer <token>'

The studio’s voicemails, newest first.

studio
required
string format: uuid

Studio ID (UUID).

limit
integer
default: 50 >= 1 <= 200

Maximum number of voicemails to return (capped at 200).

Voicemails.

Media typeapplication/json
object
voicemails
required
Array<object>
object
guid
required
string
call_guid
required

The call that left the voicemail, if still on record.

string | null
caller
required

Caller’s phone number / caller ID.

string
r2_key
required

Storage key of the recording. Download via GET /v1/studios/{studio}/voicemails/{vm}/audio.

string
duration_seconds
required
integer | null
created_at
required
string

Example generated

{
"voicemails": [
{
"guid": "example",
"call_guid": "example",
"caller": "example",
"r2_key": "example",
"duration_seconds": 1,
"created_at": "example"
}
]
}

Missing, invalid, expired or revoked API key.

Media typeapplication/json
object
error
required

Human-readable error message.

string
code

Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).

string

Example generated

{
"error": "example",
"code": "example"
}

Not found, or belongs to another organization.

Media typeapplication/json
object
error
required

Human-readable error message.

string
code

Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).

string

Example generated

{
"error": "example",
"code": "example"
}

Too many requests for this API key. Retry after Retry-After seconds.

Media typeapplication/json
object
error
required

Human-readable error message.

string
code

Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).

string

Example generated

{
"error": "example",
"code": "example"
}
Retry-After
integer

Seconds until the rate-limit window resets.