Get contact list memberships

Get contact list memberships

get

https://api.bird.comhttp://localhost:3000https://api.bird.ai

/workspaces/{workspaceId}/contacts/{contactId}/lists

This endpoint will return a list of lists a contact is a member of.

Authorizations

MessageBird_userMessageBird_accessKey

AuthorizationstringRequired

An access token issued to a user.

Path parameters

workspaceIdstring · uuidRequired

The unique identifier of the workspace.

contactIdstringRequired

The ID of a contact.

Example: b4e02c85-c6d2-4b15-8885-e09671799c61

Responses

200

A list of lists was returned. The list can be empty if no lists are found.

application/json

nextPageTokenstringOptional

The token that can be passed as pageToken in URL to retrieve the next set of results. If missing, no more results to display.

404

The requested resource was not found.

application/json

get/workspaces/{workspaceId}/contacts/{contactId}/lists

HTTPcURLJavaScriptPython

GET /workspaces/{workspaceId}/contacts/{contactId}/lists HTTP/1.1
Host: api.bird.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "results": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "US Customers",
      "description": "A list of all US customers",
      "createdAt": "2026-07-20T00:41:40.296Z",
      "updatedAt": "2026-07-20T00:41:40.296Z",
      "contactCount": 100,
      "consentType": "single",
      "tags": [
        "123e4567-e89b-12d3-a456-426614174000"
      ],
      "isProof": true,
      "counter": {
        "count": 1,
        "updatedAt": "2026-07-20T00:41:40.296Z"
      }
    }
  ],
  "nextPageToken": "text"
}

Examples

Let's establish some of our data that will be used in the following examples:

• Workspace ID: a1405560-c8d3-4b1a-877d-3f449ad95352

• AccessKey: abcd

• List ID: 123e4567-e89b-12d3-a456-426614174000

• Contact ID: 12bd0e40-9361-4e32-8b26-99b4ab7eae09

Get the lists a contact is assigned to

In this example, we're listing all the lists a contact is assigned to given a contact ID.

Request

curl -X GET "https://api.bird.com/workspaces/a1405560-c8d3-4b1a-877d-3f449ad95352/contacts/12bd0e40-9361-4e32-8b26-99b4ab7eae09/lists" \
-H "Content-Type: application/json" \
-H "Authorization: AccessKey abcd"

Response (200 OK)