---
title: "Find contact lists"
method: GET
path: "/contacts/lists"
tags: ["contacts"]
---

# Find contact lists

`GET /contacts/lists`

Searches for all contact lists which are available for the current user. Returns a paged list of contact lists

## Query parameters

- `fields` string
- `limit` integer
- `offset` integer
- `name` string
- `exactMatch` boolean
- `contactCount` integer
- `orderBy` string

## Response `200`

successful operation

- ContactListPage — ~
  - `items` object[] — A list of returned items
    - `id` integer — An Id of a contact list
    - `name` string — A name of a contact list
    - `size` integer — A number of contacts in a contact list
    - `created` integer — A time when a given resource was created, formatted in unix time milliseconds (read only). Example: 1473781817000 for Sat, 05 Jan 1985 14:03:37 GMT
    - `status` 'ACTIVE' | 'VALIDATING' | 'IMPORTING' | 'IMPORT_FAILED' | 'ERRORS' | 'DELETED' | 'PARSE_FAILED' | 'COLUMN_TOO_LARGE' — A current status of a contact list, available values: ACTIVE - contact list is ready, VALIDATING - contact list validation is in progress, IMPORTING - importing is in progress, IMPORT_FAILED - in case of errors occurred during the importing, ERRORS - contact list has validation errors, DELETED - contact list was deleted, PARSE_FAILED - contacts cannot be parsed, COLUMN_TOO_LARGE - if size of phone number or any other column exceeds 255 characters
  - `limit` integer — A maximum number of returned items. If items.size() < limit assume no more items
  - `offset` integer — An offset from a start of paging source
  - `totalCount` integer — Total count of available results. -1 if unknown

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/callfire/apis/callfire-api-documentation.md) · [All operations](https://skmtc.dev/callfire/apis/callfire-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/callfire/callfire-api-documentation/revisions/9f6fb501bc03/schema)