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

# Find contacts

`GET /contacts`

Find user's contacts by id, contact list, or on any property name. Returns a paged list of contacts

## Query parameters

- `fields` string
- `limit` integer
- `offset` integer
- `id` integer[]
- `number` string[]
- `contactListId` integer
- `propertyName` string
- `propertyValue` string

## Response `200`

successful operation

- ContactPage — ~
  - `items` object[] — A list of returned items
    - `id` integer — An id of a contact
    - `firstName` string — A first name of a contact
    - `lastName` string — A last name of a contact
    - `zipcode` string — A Zip code of a contact
    - `homePhone` string — Phone number in E.164 format (11-digit). Example: 12132000384
    - `workPhone` string — Phone number in E.164 format (11-digit). Example: 12132000384
    - `mobilePhone` string — Phone number in E.164 format (11-digit). Example: 12132000384
    - `extraPhone1` string — Phone number in E.164 format (11-digit). Example: 12132000384
    - `extraPhone2` string — Phone number in E.164 format (11-digit). Example: 12132000384
    - `extraPhone3` string — Phone number in E.164 format (11-digit). Example: 12132000384
    - `externalId` string — An external id of a contact for syncing with external sources
    - `externalSystem` string — External system that external id refers to
    - `properties` object — Map of user-defined string properties for contact
    - `deleted` boolean — A deleted contact, deleted contacts are hidden from search results
  - `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)