Skip to main content

List all outbound profiles



Returns a list of your outbound profiles.


Query Parameters

    whitelisted_destination_format string

    Possible values: [alpha2, alpha3, iso_numeric]

    Default value: alpha3

    Format of your whitelisted destinations.

    page integer

    Default value: 1

    Page number of results to load

    per_page integer

    Possible values: <= 1000

    Default value: 100

    Number of results per page

    filter[name] string

    Optional filter on outbound profile name

    sort string

    Available sort parameters are active, created_at, name, service_plan, traffic_type, and usage_payment_method. You may sort on any combination of these. Prepend a field name with a - to sort on that field in descending order.


200: Outbound Profile response


  • Array [

  • id stringrequired
    user_id stringrequired
    connections object[]required
    name stringrequired

    A user-supplied name to help with organization

    traffic_type integerrequired

    Possible values: [1, 2]

    Default value: 1

    Conversational = 1, Short Duration = 2

    service_plan integerrequired

    Possible values: [1, 2, 4]

    Default value: 4

    Indicates the coverage of the termination regions. International and Global are the same but International may only be used for high volume/short duration outbound profiles. 3 (EEA originated) has been retired and is now covered by Global. Possible values are: US = 1, International = 2, Global = 4

    cps_limit integerrequired

    Default value: 100

    ports integerrequired

    Must be no more than your concurrent call limit. Null means no limit.

    translation_rule stringrequired
    active booleanrequired

    Default value: true

    Defaults to true

    cps_limit_increase integerrequired
    tag_list string[]required
    usage_payment_method string

    Possible values: [tariff, rate-deck]

    Default value: rate-deck

    custom_rate_deck booleanrequired

    Default value: false

    rate_deck_url stringrequired

    url to rate deck

    whitelisted_destination_format string

    Possible values: [alpha2, alpha3, iso_numeric]

    Default value: alpha3

    Format of your whitelisted destinations.

    whitelisted_destinations string[]

    Default value: US,CA

    The list of destinations you want to be able to call using this outbound profile.

    max_destination_rate float

    Maximum rate at which you can make a call using this outbound profile

    connection_id string

    To be deprecated, maintained for backward compatibility

    call_recording_type stringrequired

    Possible values: [all, none, by_call_phone_number]

    Defines how to filter which calls are recorded.

    call_recording_phone_numbers string[]required

    When call_recording_type is set to by_caller_phone_number, only outbound calls using one of these numbers will be recorded. Numbers must be specified in E164 format.

    call_recording_format stringrequired

    Possible values: [wav, mp3]

    Default value: wav

    The audio file format for calls being recorded.

    call_recording_channels stringrequired

    Possible values: [single, dual]

    Default value: single

    When using 'dual' channels, final audio file will be stereo recorded with the first leg on channel A, and the rest on channel B.

    daily_spend_limit stringrequired

    The maximum amount of usage charges, in USD, you want Telnyx to allow on this outbound profile in a day before disallowing new calls. Example: 100.00.

    daily_spend_limit_enabled booleanrequired

    Default value: false

    Specifies whether to enforce the daily_spend_limit on this outbound profile.

    billing_group_id stringrequired

    The ID of the billing group to which the outbound profile is assigned. Defaults to null (for no group assigned).

  • ]

401: Unauthorized