Skip to main content
GET
/
v1
/
audiences
/
{audienceId}
/
contacts
List Contacts
curl --request GET \
  --url https://api.example.com/v1/audiences/{audienceId}/contacts
​
audienceId
string
required
The ID of the audience.
​
limit
integer
default:"20"
Number of contacts to return (max 100).
​
offset
integer
default:"0"
Number of contacts to skip.

​
Request

cURL
curl "https://www.unosend.co/api/v1/audiences/aud_123/contacts?limit=10" \
  -H "Authorization: Bearer un_xxxxxxxxxx"

​
Response

200
{
  "data": [
    {
      "id": "con_123",
      "email": "[email protected]",
      "first_name": "John",
      "last_name": "Doe",
      "unsubscribed": false,
      "created_at": "2024-01-15T10:30:00.000Z"
    }
  ],
  "total": 1250,
  "limit": 10,
  "offset": 0
}