List delivery attempts

Recent finished-URL callback deliveries for one application — the same records the console's deliveries inspector shows.

Details

Description	Lists the finished-URL callback deliveries for one application, newest first. When an application has a finishedUrl, Voylo POSTs each call's CDR there after hangup and records every attempt.
HTTP Method	GET
Endpoint URL	`/v1/applications/:id/deliveries`
Authorization	API key as a bearer token — `Authorization: Bearer $VOYLO_API_KEY`. The application must belong to the key's workspace, otherwise `404`. See Authentication.

Request parameters

Parameter	Description	Location	Constraints	Default
`id`	The application's id.	Path	uuid (required)	—
`page`	1-based page number.	Query	integer ≥ 1	`1`
`limit`	Rows per page.	Query	integer 1–100 (capped)	`20`

Request example

cURL

curl https://voylo.ai/v1/applications/8f3b1c2e-9a4d-4e7f-8b21-6c5d4e3f2a1b/deliveries \
  -H "Authorization: Bearer $VOYLO_API_KEY"

Success response example

200 OK

{
  "data": [
    {
      "id": "d1e2f3a4-b5c6-7d8e-9f01-2a3b4c5d6e7f",
      "eventType": "call.completed",
      "eventId": "evt_5c4d3e2f1a0b",
      "status": "delivered",
      "attempts": 1,
      "responseStatus": 200,
      "lastError": null,
      "nextAttemptAt": "2026-06-23T11:02:14.000Z",
      "createdAt": "2026-06-23T11:02:13.000Z",
      "deliveredAt": "2026-06-23T11:02:14.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "totalItems": 1,
    "totalPages": 1
  }
}

Description

dataarray — The page of delivery records.
- iduuid — Delivery id.
- eventTypestring — The event delivered, e.g. call.completed.
- eventIdstring — Stable id for the source event.
- statusenum — pending · delivered · failed.
- attemptsinteger — Delivery attempts made so far.
- responseStatusinteger | null — HTTP status your endpoint returned on the latest attempt.
- lastErrorstring | null — Error from the latest failed attempt, if any.
- nextAttemptAttimestamp — When the next retry is scheduled.
- createdAttimestamp — When the delivery was first queued.
- deliveredAttimestamp | null — When it was successfully delivered.
paginationobject — Page metadata (page, limit, totalItems, totalPages).

Possible errors

Error	Description
400 Bad Request	id is not a valid UUID, or page/limit is invalid.
401 Unauthorized	API key is missing, invalid, or revoked.
403 Forbidden	The key's role doesn't permit this action.
404 Not Found	No application with that id in the key's workspace.

For the full payload and response body of a single attempt, see Get a delivery. To re-fire one with fresh enrichment, see Resend a delivery.

← Previous

Delete an application

Get a delivery