List applications

Returns the applications in your workspace, newest first, in the standard paginated envelope.

Details

Description	Lists the applications in the API key's workspace, newest first, with optional name search.
HTTP Method	GET
Endpoint URL	`/v1/applications`
Authorization	API key as a bearer token — `Authorization: Bearer $VOYLO_API_KEY`. The key is bound to a workspace, so results are scoped automatically. See Authentication.

Request parameters

Parameter	Description	Location	Constraints	Default
`page`	1-based page number.	Query	integer ≥ 1	`1`
`limit`	Rows per page.	Query	integer 1–100 (capped)	`10`
`search`	Case-insensitive filter on the application name.	Query	string	—

Request example

cURL

curl "https://voylo.ai/v1/applications?limit=10" \
  -H "Authorization: Bearer $VOYLO_API_KEY"

Success response example

200 OK

{
  "data": [
    {
      "id": "8f3b1c2e-9a4d-4e7f-8b21-6c5d4e3f2a1b",
      "name": "Support hotline",
      "actionUrl": "https://api.example.com/voylo/inbound",
      "finishedUrl": null,
      "recording": "per_call"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "totalItems": 1,
    "totalPages": 1
  }
}

API-key requests get this trimmed item shape — the fields a programmatic integration needs to identify and route an application. The console (session-authenticated) gets the full record. To read every field for one application, use Get an application.

Description

dataarray — The page of application records.
- iduuid — Application id.
- namestring — Display name.
- actionUrlstring | null — URL Voylo POSTs to at each call step to fetch fresh VoyloML.
- finishedUrlstring | null — Post-call CDR delivery URL.
- recordingenum — always · never · per_call.
paginationobject — Page metadata.
- pageinteger — Current page.
- limitinteger — Rows per page.
- totalItemsinteger — Total rows across all pages.
- totalPagesinteger — Total pages at this limit (≥ 1).

Possible errors

Error	Description
400 Bad Request	page or limit is not a positive integer.
401 Unauthorized	API key is missing, invalid, or revoked.
403 Forbidden	The key's role doesn't permit this action.

← Previous

Phone widget

Get an application