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

# List Contacts

> Retrieve a paginated list of contacts.

Returns your subscriber list with optional filtering by status or segment.

### Query Parameters

<ParamField query="limit" type="integer">Max items (default: 50, max: 100)</ParamField>
<ParamField query="unsubscribed" type="boolean">Filter by opt-out status</ParamField>

### Response

<ResponseField name="data" type="object[]">Array of contacts</ResponseField>


## Related topics

- [Contacts](/audience/contacts.md)
- [Segments](/audience/segments.md)
- [Migration Guide](/audience/migration-guide.md)
- [Introduction](/audience/introduction.md)
- [SDKs](/sdks/index.md)