> ## Documentation Index
> Fetch the complete documentation index at: https://docs-dev.setoo.work/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List contacts

> Retrieve contacts within a contact list with pagination

Returns the contacts inside a contact list. When query parameters are omitted, returns the full contact list.

### Path parameters

<ParamField path="listId" type="string" required>
  The unique UUID of the contact list.
</ParamField>

### Query parameters

<ParamField query="page" type="integer" default="1">
  1-based page number.
</ParamField>

<ParamField query="limit" type="integer" default="25">
  Number of contacts per page (maximum 200).
</ParamField>

<CodeGroup>
  ```bash curl theme={null}
  curl -X GET "https://api.agentic-os.com/api/v1/contact-lists/33333333-3333-3333-3333-333333333333/contacts?page=1&limit=25" \
    -H "Authorization: Bearer $AGENTIC_OS_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.agentic-os.com/api/v1/contact-lists/33333333-3333-3333-3333-333333333333/contacts",
      headers={"Authorization": f"Bearer {API_KEY}"},
      params={"page": 1, "limit": 25},
  )
  print(response.json())
  ```

  ```javascript Node theme={null}
  const response = await fetch(
    "https://api.agentic-os.com/api/v1/contact-lists/33333333-3333-3333-3333-333333333333/contacts?page=1&limit=25",
    {
      method: "GET",
      headers: { Authorization: `Bearer ${API_KEY}` },
    },
  );
  const data = await response.json();
  console.log(data);
  ```
</CodeGroup>

### Response

```json theme={null}
{
  "data": [
    {
      "id": "99999999-8888-7777-6666-555555555555",
      "tenantId": "990e8400-e29b-41d4-a716-446655440000",
      "contactListId": "33333333-3333-3333-3333-333333333333",
      "phoneNumber": "+919876543210",
      "name": "Asha Patel",
      "email": "asha.patel@example.com",
      "metadata": {
        "plan": "Enterprise"
      },
      "createdAt": "2026-06-01T09:10:00.000Z",
      "updatedAt": "2026-06-01T09:10:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 25
}
```