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

# List contacts

`GET /api/v1/contacts`

## Request

- Base URL: `https://app.drillerdb.com`
- URL: `https://app.drillerdb.com/api/v1/contacts`
- Auth: API key in header `X-API-Key`

List contacts Requires an Enterprise-plan API key (X-API-Key header) carrying the contacts:read scope.

## Query parameters

- `limit` integer
- `cursor` string
- `updated_since` string, date-time

## Response `200`

A paginated list of contacts.

- ContactListResponse
  - `data` Contact[], required
    - `id` integer, required
    - `business_name` string, nullable
    - `first_name` string, nullable
    - `last_name` string, nullable
    - `email` string, nullable
    - `billing_email` string, nullable
    - `phone` string, nullable
    - `cell` string, nullable
    - `address` Address, required
      - `line1` string, nullable
      - `line2` string, nullable
      - `city` string, nullable
      - `state` string, nullable
      - `postal_code` string, nullable
    - `is_client` boolean, required
    - `is_vendor` boolean, required
    - `is_active` boolean, required
    - `updated_at` string, date-time, nullable
  - `meta` ListMeta, required
    - `request_id` string, required
    - `limit` integer, required
    - `has_more` boolean, required
    - `next_cursor` string, nullable, required
  - `links` ListLinks, required
    - `self` string, required
    - `next` string

## Other responses

- `401`: Missing, invalid, inactive, or expired API key.
- `403`: The API key lacks scope or the company is not entitled to API access.
- `405`: The path exists but not for this HTTP method. Every route is GET (HEAD and OPTIONS are also accepted).
- `429`: The key exceeded its configured rate limits.
- `503`: The public API schema has not been migrated in this environment yet.

---

[API](https://skmtc.dev/drillerdb/apis/drillerdb-public-apis.md) · [All operations](https://skmtc.dev/drillerdb/apis/drillerdb-public-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/drillerdb/apis/drillerdb-public-apis/revisions/aeb372774d99?raw)