DocumentazioneEngagement Platform API
Sign inGet started
Guides
API

Get a list

GET
/workspaces/{workspaceId}/lists/{listId}
Get the specified list given its ID.
Parametri di percorso
workspaceId
string
The unique identifier of the workspace.
listId
string
The ID of a list.
Payload della risposta
id
string
obbligatorio
The unique identifier for the list.
name
string
obbligatorio
The name of the list.
description
string
obbligatorio
The description of the list.
createdAt
string
updatedAt
string
contactCount
integer
The number of contacts in the list.
consentType
string
The consent type for the list.
Possible values: single, double
tags
array of string
The tags associated with the list.
isProof
boolean
The list is used as a proof list to use it as a test list in campaigns.
counter
object
Mostra attributi secondari
counter.count
integer
obbligatorio
counter.updatedAt
string
obbligatorio
Esempio di codice
curl -X GET 'https://api.bird.com/workspaces/{workspaceId}/lists/{listId}' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'

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

Get a list

In this example, we are fetching the list given its ID.
Esempio di codice
curl -X GET "https://api.bird.com/workspaces/a1405560-c8d3-4b1a-877d-3f449ad95352/lists/123e4567-e89b-12d3-a456-426614174000" \
-H "Content-Type: application/json" \
-H "Authorization: AccessKey abcd"