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

# List Contacts

> Fetch all profiles with their segmentation and health status. Supports filtering by specific list segments.

### Query Parameters

<ParamField query="page" type="integer">
  Page number
</ParamField>

<ParamField query="limit" type="integer">
  Number of records per page
</ParamField>

<ParamField query="search" type="string">
  Filter by name or email
</ParamField>

<ParamField query="recipient_list_id" type="string">
  Filter contacts belonging to a specific segment.
</ParamField>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "recipients": [
        {
          "id": "rec-123",
          "email": "john@doe.com",
          "name": "John",
          "lists": [
            {
              "id": "list-1",
              "name": "Leads"
            }
          ]
        }
      ],
      "pagination": {
        "total": 100,
        "page": 1,
        "limit": 20,
        "pages": 5
      }
    }
  }
  ```
</ResponseExample>