GET /experience-connections

List all Experience Connections

Retrieve list of all Experience Connections for the given account

Authentication

OAuth 2.0. Required scope(s): experience-connections:manage.

Request

Path parameters

None.

Query parameters

Name Type Required Description
accountId string (uuid) no Filter by account ID. If present, the tn filter is ignored; if not present, tn is required.
tn string (E.164) no Filter by the account associated with the supplied telephone number. Required only when accountId is not provided.
cursor string no The cursor value returned from a previous paginated request. Used to retrieve the next page of results. When not provided, the first page of results is returned.
experienceId string (uuid) no Filter by Experience ID
pageSize integer no The number of items to return per page. Used in conjunction with cursor for pagination. Default is 100, valid range between 1 and 100.

Headers

None.

Responses

200 — Experience Connections retrieved successfully

Content-Type: application/json

Schema: PagedExperienceConnectionList

Field Type Required Description
entities array of ExperienceConnection yes List of Experience Connections for the current page
cursor string no Cursor value to retrieve the next page of results. Null if there are no more pages.
pageSize integer yes Number of items per page

Spec gap. Cursor token behaviour is not documented — format, expiry, and stale-cursor error handling are unspecified. Treat cursor values as opaque strings; do not parse or cache them beyond the immediate pagination loop.

Gap ID 3094ffc737e8

Example:

{
  "pageSize": 100,
  "entities": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "accountId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "accountName": "Acme Communications",
      "experienceId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "state": "INACTIVE"
    }
  ],
  "cursor": null
}

400 — Bad Request - A query parameter was set with an invalid value

Content-Type: application/problem+json

Schema: ProblemDetails

Example:

{
  "title": "Bad Request",
  "status": 400,
  "detail": "accountId is required",
  "traceId": "6d4a3a62-0d4b-4b96-9171-8c5070e01c35"
}

401 — Unauthorized - Missing or expired access token. Obtain a new token and retry.

Content-Type: application/problem+json

Schema: ProblemDetails

Example:

{
  "title": "Unauthorized",
  "status": 401,
  "detail": "Access token is missing or has expired",
  "traceId": "6d4a3a62-0d4b-4b96-9171-8c5070e01c35"
}

Errors

This operation may return:

  • 400 — Bad Request - A query parameter was set with an invalid value
  • 401 — Unauthorized - Missing or expired access token. Obtain a new token and retry.

See Errors reference for the full catalogue.