Skip to main content

Display information about allocatable global outbound channels for the current user.

GET 
/managed_accounts/allocatable_global_outbound_channels

Display information about allocatable global outbound channels for the current user. Only usable by account managers.

Responses​

200: Successful response with information about allocatable global outbound channels.

Schema

    data

    Managed Accounts Global Outbound Channels

    managed_account_allow_custom_pricing boolean

    Boolean value that indicates if the managed account is able to have custom pricing set for it or not. If false, uses the pricing of the manager account. Defaults to false. This value may be changed, but there may be time lag between when the value is changed and pricing changes take effect.

    allocatable_global_outbound_channels integer

    The total amount of allocatable global outbound channels available to the authenticated manager. Will be 0 if the feature is not enabled for their account.

    record_type string

    The type of the data contained in this record.

    total_global_channels_allocated integer

    The total number of allocatable global outbound channels currently allocated across all managed accounts for the authenticated user. This includes any amount of channels allocated by default at managed account creation time. Will be 0 if the feature is not enabled for their account.

401: Unauthenticated response. Happens when the current user cannot be authenticated.

403: Unauthorized response. Happens when the current user is not authorized to access the endpoint.

Request samples

curl -L 'https://api.telnyx.com/v2/managed_accounts/allocatable_global_outbound_channels' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

Response samples

{
  "data": {
    "allocatable_global_outbound_channels": 500,
    "record_type": "allocatable_global_outbound_channels",
    "total_global_channels_allocated": 135
  }
}