Skip to main content
GET
/
audience
/
lists
/
{listId}
Show an audience list
curl --request GET \
  --url https://app.lettr.com/api/audience/lists/{listId} \
  --header 'Authorization: Bearer <token>'
{
  "message": "List retrieved successfully.",
  "data": {
    "id": "0193e6a8-1f3a-7c2a-b9e2-1aa1d2e5d3f0",
    "name": "Newsletter subscribers",
    "contacts_count": 124
  }
}
Retrieve a single audience list. Requires the audience:read scope.

Authorizations

​
Authorization
string
header
required

API key for authentication

Path Parameters

​
listId
string<uuid>
required

List ID

Response

List retrieved successfully.

​
message
string
required
Example:

"List retrieved successfully."

​
data
object
required

Audience list summary