List voicemails
GET/api/v1/domains/:domain_uuid/voicemails
Returns voicemails for the specified domain the caller is allowed to access.
Access rules:
- Caller must have access to the target domain (domain scope).
- Caller must have the
voicemail_domainpermission.
Pagination (cursor-based):
- Both
limitandstarting_afterare optional. - If
limitis not provided, it defaults to 50. - If
starting_afteris not provided, results start from the beginning. - If
has_moreis true, request the next page by passingstarting_afterequal to the last item'svoicemail_uuidfrom the previous response.
Examples:
- First page:
GET /api/v1/domains/{domain_uuid}/voicemails - Next page:
GET /api/v1/domains/{domain_uuid}/voicemails?starting_after={last_voicemail_uuid} - Custom size:
GET /api/v1/domains/{domain_uuid}/voicemails?limit=50
Request
Responses
- 200
- 400
- 401
- 403
- 404
Success
Invalid starting_after UUID
Unauthenticated
Forbidden (domain access)
Not found