Retrieve a list of all Services for Twilio Proxy. A maximum of 100 records will be returned per page.

GET /v1/Services

Retrieve a list of all Services for Twilio Proxy. A maximum of 100 records will be returned per page.

Query parameters

  • PageSize integer(int64)

    How many resources to return in each list page. The default is 50, and the maximum is 1000.

    Minimum value is 1, maximum value is 1000.

  • Page integer

    The page index. This value is simply for client state.

    Minimum value is 0.

  • PageToken string

    The page token. This is provided by the API.

Responses

  • 200 application/json

    OK

    Hide headers attributes Show headers attributes
    • Access-Control-Allow-Origin string

      Specify the origin(s) allowed to access the resource

    • Access-Control-Allow-Methods string

      Specify the HTTP methods allowed when accessing the resource

    • Access-Control-Allow-Headers string

      Specify the headers allowed when accessing the resource

    • Access-Control-Allow-Credentials boolean

      Indicates whether the browser should include credentials

    • Access-Control-Expose-Headers string

      Headers exposed to the client

    Hide response attributes Show response attributes object
    • services array[object]
      Hide services attributes Show services attributes object
      • sid string | null

        The unique string that we created to identify the Service resource.

        Minimum length is 34, maximum length is 34. Format should match the following pattern: ^KS[0-9a-fA-F]{32}$.

      • unique_name string | null

        An application-defined string that uniquely identifies the resource. This value must be 191 characters or fewer in length and be unique. Supports UTF-8 characters. This value should not have PII.

      • account_sid string | null

        The SID of the Account that created the Service resource.

        Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.

      • chat_instance_sid string | null

        The SID of the Chat Service Instance managed by Proxy Service. The Chat Service enables Proxy to forward SMS and channel messages to this chat instance. This is a one-to-one relationship.

        Minimum length is 34, maximum length is 34. Format should match the following pattern: ^IS[0-9a-fA-F]{32}$.

      • callback_url string(uri) | null

        The URL we call when the interaction status changes.

      • default_ttl integer

        The default ttl value for Sessions created in the Service. The TTL (time to live) is measured in seconds after the Session's last create or last Interaction. The default value of 0 indicates an unlimited Session length. You can override a Session's default TTL value by setting its ttl value.

        Default value is 0.

      • number_selection_behavior string

        The preference for Proxy Number selection in the Service instance. Can be: prefer-sticky or avoid-sticky. prefer-sticky means that we will try and select the same Proxy Number for a given participant if they have previous Sessions, but we will not fail if that Proxy Number cannot be used. avoid-sticky means that we will try to use different Proxy Numbers as long as that is possible within a given pool rather than try and use a previously assigned number.

        Values are avoid-sticky or prefer-sticky.

      • geo_match_level string

        Where a proxy number must be located relative to the participant identifier. Can be: country, area-code, or extended-area-code. The default value is country and more specific areas than country are only available in North America.

        Values are area-code, overlay, radius, or country.

      • intercept_callback_url string(uri) | null

        The URL we call on each interaction. If we receive a 403 status, we block the interaction; otherwise the interaction continues.

      • out_of_session_callback_url string(uri) | null

        The URL we call when an inbound call or SMS action occurs on a closed or non-existent Session. If your server (or a Twilio function) responds with valid TwiML, we will process it. This means it is possible, for example, to play a message for a call, send an automated text message response, or redirect a call to another Phone Number. See Out-of-Session Callback Response Guide for more information.

      • date_created string(date-time) | null

        The ISO 8601 date and time in GMT when the resource was created.

      • date_updated string(date-time) | null

        The ISO 8601 date and time in GMT when the resource was last updated.

      • url string(uri) | null

        The absolute URL of the Service resource.

    • meta object
      Hide meta attributes Show meta attributes object
      • first_page_url string(uri)
      • key string
      • next_page_url string(uri) | null
      • page integer
      • page_size integer
      • previous_page_url string(uri) | null
      • url string(uri)
GET /v1/Services
curl \
 --request GET 'https://proxy.twilio.com/v1/Services' \
 --user "username:password"
Response examples (200)
{
  "meta": {
    "key": "services",
    "url": "https://proxy.twilio.com/v1/Services?PageSize=50&Page=0",
    "page": 0,
    "page_size": 50,
    "next_page_url": null,
    "first_page_url": "https://proxy.twilio.com/v1/Services?PageSize=50&Page=0",
    "previous_page_url": null
  },
  "services": []
}