List service

GET /v2/Services

Top level scope for all chat resources

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: ^IS[0-9a-fA-F]{32}$.

      • 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}$.

      • friendly_name string | null

        The string that you assigned to describe the resource.

      • date_created string(date-time) | null

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

      • date_updated string(date-time) | null

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

      • default_service_role_sid string | null

        The service role assigned to users when they are added to the service. See the Role resource for more info about roles.

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

      • default_channel_role_sid string | null

        The channel role assigned to users when they are added to a channel. See the Role resource for more info about roles.

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

      • default_channel_creator_role_sid string | null

        The channel role assigned to a channel creator when they join a new channel. See the Role resource for more info about roles.

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

      • read_status_enabled boolean | null

        Whether the Message Consumption Horizon feature is enabled. The default is true.

      • reachability_enabled boolean | null

        Whether the Reachability Indicator is enabled for this Service instance. The default is false.

      • typing_indicator_timeout integer

        How long in seconds after a started typing event until clients should assume that user is no longer typing, even if no ended typing message was received. The default is 5 seconds.

        Default value is 0.

      • consumption_report_interval integer

        DEPRECATED. The interval in seconds between consumption reports submission batches from client endpoints.

        Default value is 0.

      • limits

        An object that describes the limits of the service instance. The limits object contains channel_members to describe the members/channel limit and user_channels to describe the channels/user limit. channel_members can be 1,000 or less, with a default of 250. user_channels can be 1,000 or less, with a default value of 100.

      • pre_webhook_url string | null

        The URL for pre-event webhooks, which are called by using the webhook_method. See Webhook Events for more details.

      • post_webhook_url string | null

        The URL for post-event webhooks, which are called by using the webhook_method. See Webhook Events for more details.

      • webhook_method string | null

        The HTTP method to use for calls to the pre_webhook_url and post_webhook_url webhooks. Can be: POST or GET and the default is POST. See Webhook Events for more details.

      • webhook_filters array[string] | null

        The list of webhook events that are enabled for this Service instance. See Webhook Events for more details.

      • pre_webhook_retry_count integer

        The number of times to retry a call to the pre_webhook_url if the request times out (after 5 seconds) or it receives a 429, 503, or 504 HTTP response. Default retry count is 0 times, which means the call won't be retried.

        Default value is 0.

      • post_webhook_retry_count integer

        The number of times to retry a call to the post_webhook_url if the request times out (after 5 seconds) or it receives a 429, 503, or 504 HTTP response. The default is 0, which means the call won't be retried.

        Default value is 0.

      • notifications

        The notification configuration for the Service instance. See Push Notification Configuration for more info.

      • media

        An object that describes the properties of media that the service supports. The object contains the size_limit_mb property, which describes the size of the largest media file in MB; and the compatibility_message property, which contains the message text to send when a media message does not have any text.

      • 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 /v2/Services
curl \
 --request GET 'https://chat.twilio.com/v2/Services' \
 --user "username:password"
Response examples (200)
{
  "meta": {
    "key": "services",
    "url": "https://chat.twilio.com/v2/Services?PageSize=50&Page=0",
    "page": 0,
    "page_size": 50,
    "next_page_url": null,
    "first_page_url": "https://chat.twilio.com/v2/Services?PageSize=50&Page=0",
    "previous_page_url": null
  },
  "services": []
}
{
  "meta": {
    "key": "services",
    "url": "https://chat.twilio.com/v2/Services?PageSize=50&Page=0",
    "page": 0,
    "page_size": 50,
    "next_page_url": null,
    "first_page_url": "https://chat.twilio.com/v2/Services?PageSize=50&Page=0",
    "previous_page_url": null
  },
  "services": [
    {
      "sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "url": "https://chat.twilio.com/v2/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "links": {
        "roles": "https://chat.twilio.com/v2/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Roles",
        "users": "https://chat.twilio.com/v2/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Users",
        "bindings": "https://chat.twilio.com/v2/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Bindings",
        "channels": "https://chat.twilio.com/v2/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Channels"
      },
      "media": {
        "size_limit_mb": 150,
        "compatibility_message": "media compatibility message"
      },
      "limits": {
        "user_channels": 250,
        "channel_members": 100
      },
      "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "date_created": "2015-07-30T20:00:00Z",
      "date_updated": "2015-07-30T20:00:00Z",
      "friendly_name": "friendly_name",
      "notifications": {},
      "webhook_method": "webhook_method",
      "pre_webhook_url": "pre_webhook_url",
      "webhook_filters": [
        "webhook_filters"
      ],
      "post_webhook_url": "post_webhook_url",
      "read_status_enabled": false,
      "reachability_enabled": false,
      "pre_webhook_retry_count": 2,
      "default_channel_role_sid": "RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "default_service_role_sid": "RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "post_webhook_retry_count": 3,
      "typing_indicator_timeout": 100,
      "consumption_report_interval": 100,
      "default_channel_creator_role_sid": "RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    }
  ]
}