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

# List contacts

`GET /contacts`

## Request

- Base URL: `https://mobcrm.au/api/v1`
- URL: `https://mobcrm.au/api/v1/contacts`
- Auth: HTTP bearer

## Query parameters

- `page` integer
- `per_page` integer
- `include_deleted` boolean
- `status` 'active' | 'archived' | 'deceased'
- `is_favorite` boolean
- `search` string
- `company` string
- `tag_name` string
- `sort_by` string
- `sort_order` 'asc' | 'desc'

## Response `200`

Paginated contacts.

- object
  - `data` Contact[], required
    - `id` string
    - `first_name` string
    - `middle_name` string
    - `last_name` string
    - `nickname` string
    - `gender` string
    - `pronouns` string
    - `birthday_mode` 'full_date' | 'month_day' | 'approximate_age'
    - `birthday_date` string
    - `status` 'active' | 'archived' | 'deceased'
    - `is_favorite` boolean
    - `job_title` string
    - `company` string
    - `created_at` string
    - `updated_at` string
  - `meta` PaginationMeta
    - `total` integer, required
    - `page` integer, required
    - `per_page` integer, required
    - `total_pages` integer, required

## Other responses

- `401`: Missing, malformed, or invalid bearer token.
- `403`: Token lacks the required scope or plan entitlement.
- `429`: Rate limit exceeded; see the Retry-After header.

---

[API](https://skmtc.dev/mobcrm/apis/mob-crm-public-api.md) · [All operations](https://skmtc.dev/mobcrm/apis/mob-crm-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mobcrm/apis/mob-crm-public-api/revisions/697e8afba2a5?raw)