Retrieve a list of all push notification bindings in the conversation service

GET /v1/Services/{ChatServiceSid}/Bindings

A Binding resource represents a push notification binding and its configuration, for delivering conversation events to mobile or web endpoints.

Path parameters

ChatServiceSid string Required

The SID of the Conversation Service the Binding resource is associated with.

Query parameters

BindingType array[string]

The push technology used by the Binding resources to read. Can be: apn, gcm, or fcm. See push notification configuration for more info.
Identity array[string]

The identity of a Conversation User this binding belongs to. See access tokens for more details.
PageSize integer

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.

Responses

• 200

OK
Hide response attributes Show response attributes object
- bindings array[object]
  
  Hide bindings attributes Show bindings attributes
  
  account_sid string | null
  
  The unique ID of the Account responsible for this binding.
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.
  
  binding_type string | null
  
  The push technology to use for the binding.
  
  Values are apn, gcm, or fcm.
  
  chat_service_sid string | null
  
  The SID of the Conversation Service that the resource is associated with.
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^IS[0-9a-fA-F]{32}$.
  
  credential_sid string | null
  
  The SID of the Credential for the binding.
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^CR[0-9a-fA-F]{32}$.
  
  date_created string(date-time) | null
  
  The date that this resource was created.
  
  date_updated string(date-time) | null
  
  The date that this resource was last updated.
  
  endpoint string | null
  
  The unique endpoint identifier for the Binding.
  
  identity string | null
  
  The identity of Conversation User associated with this binding.
  
  message_types array[string] | null
  
  The Conversation message types the binding is subscribed to.
  
  sid string | null
  
  A 34 character string that uniquely identifies this resource.
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^BS[0-9a-fA-F]{32}$.
  
  url string(uri) | null
  
  An absolute URL for this binding.
- meta object
  
  Hide meta attributes Show meta attributes
  
  first_page_url string(uri)
  
  key string
  
  next_page_url string(uri)
  
  page integer
  
  page_size integer
  
  previous_page_url string(uri)
  
  url string(uri)

GET /v1/Services/{ChatServiceSid}/Bindings

curl \
 -X GET https://conversations.twilio.com/v1/Services/{ChatServiceSid}/Bindings \
 --user "username:password"

Response examples (200)

{
  "bindings": [
    {
      "account_sid": "string",
      "binding_type": "apn",
      "chat_service_sid": "string",
      "credential_sid": "string",
      "date_created": "2023-05-04T09:42:00+00:00",
      "date_updated": "2023-05-04T09:42:00+00:00",
      "endpoint": "string",
      "identity": "string",
      "message_types": [
        "string"
      ],
      "sid": "string",
      "url": "https://example.com"
    }
  ],
  "meta": {
    "first_page_url": "https://example.com",
    "key": "string",
    "next_page_url": "https://example.com",
    "page": 42,
    "page_size": 42,
    "previous_page_url": "https://example.com",
    "url": "https://example.com"
  }
}