# List Contacts

Lists the IDs of all contacts. Without limit, returns a flat array of all matching contact IDs (legacy behavior). With limit, returns a paginated object instead; pass the previous response's nextCursor back as cursor to continue.

Endpoint: GET /subscriber
Version: 1.0.0

## Query parameters:

  - `status` (string)
    Filter contacts by their subscription status (subscribed, pending, unsubscribed). If no value is selected, the filter defaults to subscribed, meaning only contacts with an active subscription are included.

  - `bounceStatus` (string)
    Filter contacts by their bounce status (hardbounce, softbounce, spambounce, nobounce). If no value is selected, the filter defaults to softbounce, spambounce, and nobounce.

  - `limit` (integer)
    Maximum number of contact IDs to return. If omitted, all matching contact IDs are returned (legacy behavior). If given, enables pagination and the value is capped to 500.

  - `cursor` (string)
    Opaque pagination cursor, taken unchanged from the previous page's nextCursor. Omit for the first page. Only applied when limit is given.

## Response 200:

  - `200` (unknown)
    Success Response.

## Response 200 fields (application/json):

  - `subscriberIds` (array, required)
    Page of contact IDs
    Example: ["123","456"]

  - `nextCursor` (string, required)
    Opaque cursor for the next page, or null when the last page was reached.
    Example: MToxMjM

## Response 403:

  - `403` (unknown)
    Access Denied Response (403).

Your account does not have the required permissions to access this resource.

## Response 404:

  - `404` (unknown)
    Not Found Response (404).

The specified resource could not be found.

## Response 406:

  - `406` (unknown)
    Not Acceptable Response (406).
Check the response content for further error details.
In some cases, a detail error code may be returned:
- `4` - Subscription not found
- `5` - Email address validation failed
- `7` - Subscriber email not found
- `8` - Field validation failed
- `9` - Subscriber not subscribed
- `10` - Subscriber update failed
- `30` - Email address change not allowed
- `31` - Untag smarttag not allowed
- `32` - Email address SMS number required
- `100` - Invalid API key
- `401` - User not found
- `402` - List not found
- `403` - Tag not found
- `404` - User group not found
- `405` - Campaign not found
- `406` - Tier not found
- `501` - Email address required
- `502` - Username required
- `503` - Password required
- `504` - First name required
- `505` - Last name required
- `506` - Username exists
- `507` - Email address exists
- `508` - User update failed