API OverviewApplication configuration

Get application configuration

View as Markdown
Get the authenticated application's assigned inbound phone numbers, permitted outbound caller IDs and SMS identities, webhook settings, and effective resource limits. This operation does not expose credentials or configuration for other applications.

Authentication

AuthorizationBearer
Application auth. Send `Authorization: Bearer <app_uuid>:<api_key>` using any active key in the app's collection. See [Authentication](https://voice-platform.docs.buildwithfern.com/api/authentication) for details.

Response

Current application configuration
app_uuidstringformat: "^app_[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
Identifier of the authenticated application.
blocked_webhook_eventslist of enums
Event types excluded from webhook delivery. An empty array means all event types are delivered.
inbound_phone_numberslist of strings
Inbound phone numbers assigned to this application, sorted in ascending canonical E.164 order. Assignment changes can take time to reach call routing.
limitsobject
outbound_caller_idslist of strings
Phone numbers this application can present as caller ID on outbound calls, sorted in ascending canonical E.164 order.
sms_identitieslist of strings

Exact, case-sensitive SMS identities this application may present to recipients, sorted by stored value. An empty array means outbound SMS is disabled.

webhook_urlstring or null
Webhook delivery URL, or null when webhook delivery is disabled.

Errors

401
Unauthorized Error
500
Internal Server Error
503
Service Unavailable Error