List Applications

Two read endpoints: list everything (paginated) on the authenticated account, or fetch one by id.

List all

Endpoint

GET https://api.tryvox.io/v1/voice/applications

Query parameters

Parameter	Type	Description
`page`	integer	1-indexed page number. Default: `1`.
`per_page`	integer	Items per page. Default: `20`, max: `100`.

Example request

curl -u $TRYVOX_AUTH_ID:$TRYVOX_AUTH_TOKEN \
  "https://api.tryvox.io/v1/voice/applications?page=1&per_page=20"

Response

200 OK:

{
  "data": [
    {
      "id": "app_8f7a4b2e91c24f3d9a1e2c4b6d8f0a1c",
      "account_id": "TJab12cd34",
      "name": "Main IVR",
      "answer_url": "https://your-app.com/answer",
      "answer_method": "POST",
      "fallback_url": "https://your-app.com/fallback",
      "hangup_url": "https://your-app.com/hangup",
      "status": "active",
      "created_at": "2026-04-09T10:30:00Z",
      "updated_at": "2026-04-09T10:30:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 1
  }
}

If no Applications are registered, data is [] and total is 0.

Get one

Endpoint

GET https://api.tryvox.io/v1/voice/applications/{id}

Example request

curl -u $TRYVOX_AUTH_ID:$TRYVOX_AUTH_TOKEN \
  https://api.tryvox.io/v1/voice/applications/app_8f7a4b2e91c24f3d9a1e2c4b6d8f0a1c

Response

200 OK:

{
  "id": "app_8f7a4b2e91c24f3d9a1e2c4b6d8f0a1c",
  "account_id": "TJab12cd34",
  "name": "Main IVR",
  "answer_url": "https://your-app.com/answer",
  "answer_method": "POST",
  "fallback_url": "https://your-app.com/fallback",
  "hangup_url": "https://your-app.com/hangup",
  "status": "active",
  "created_at": "2026-04-09T10:30:00Z",
  "updated_at": "2026-04-09T10:30:00Z"
}

Response fields

id — opaque, prefixed with app_.
account_id — the API key Auth ID that owns the Application.
name — your label.
answer_url / answer_method — VoxML fetch URL. Maps to the voice_url you submitted on create.
fallback_url / fallback_method — backup URL if answer_url fails.
hangup_url / hangup_method — final-disposition webhook.
status_callback_url / status_callback_method — per-transition webhook (only present if set).
status — active or inactive.
created_at / updated_at — ISO 8601 UTC timestamps.

Errors

Status	Code	Reason
401	`INVALID_CREDENTIALS`	Auth ID / Auth Token bad
404	`NOT_FOUND`	(single-fetch) no Application with this `id`, or it belongs to a different account

List Applications

On this page