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

# List contacts

`GET /contact/`

## Query parameters

- `_limit` integer
- `_skip` integer
- `_fields` string
- `lead_id` string

## Response `200`

Successful response

- object
  - `data` Contact[], required
    - `created_by` string, nullable, required
    - `date_created` string, date-time, required
    - `date_updated` string, date-time, required
    - `display_name` string, required
    - `emails` ContactEmail[]
      - `email` string, required
      - `is_unsubscribed` boolean, required
      - `type` string, required
    - `id` string, required
    - `integration_links` RenderedIntegrationLink[]
      - `name` string, required
      - `url` string, required
    - `lead_id` string, nullable
    - `lead_suggestions_operation_id` string, nullable
    - `name` string, nullable, required
    - `organization_id` string, required
    - `phones` ContactPhone[]
      - `country` string, nullable
      - `outbound_sms_blocked` boolean
      - `phone` string, required
      - `phone_formatted` string
      - `type` string, required
      - `tz_ids` string[]
    - `recent_calls` ContactRecentCall[]
      - `dialer_id` string, nullable, required
      - `duration` integer, required
      - `finish_timestamp` string, date-time, required
      - `id` string, required
      - `status` 'created' | 'in-progress' | 'completed' | 'cancel' | 'no-answer' | 'busy' | 'failed' | 'timeout', required — Current status of the call.
    - `subscriptions` BasicSubscriptionInfoForContact[]
      - `contact_email` string, nullable, required
      - `date_created` string, date-time, required
      - `initial_email_id` string, nullable, required
      - `sequence_id` string, required
      - `sequence_name` string, required
      - `sequence_status` 'active' | 'paused' | 'draft', required
      - `start_date` string, date-time, nullable, required
      - `subscription_id` string, required
      - `subscription_status` 'active' | 'paused' | 'finished' | 'goal' | 'error', required
      - `subscription_status_reason` 'manual' | 'pending-call-timed-out' | 'bulk-action' | 'rate-limited' | 'sequence-deleted' | 'workflow-paused' | 'filter-not-matched' | 'insufficient-ai-credit-balance' | 'reply-received' | 'call-answered' | 'meeting-booked' | 'lead-status-changed' | 'outcome-met' | 'account-invalid' | 'account-failures' | 'sending-throttled-too-long' | 'membership-inactive' | 'send-as-error' | 'email-bounced' | 'call-failed' | 'sms-failed' | 'no-user-phone' | 'billing-error' | 'assignment-field-invalid' | 'lead-status-field-invalid' | 'assignees-missing' | 'run-as-disabled' | 'lead-not-visible' | 'internal-error' | 'field-mapping-error' | 'filter-config-invalid' | 'email-ai-generation-failed', required — Reason for each higher level status on a Workflow run.
    - `timezone` string, nullable
    - `timezone_source` string, nullable
    - `title` string, nullable, required
    - `updated_by` string, nullable, required
    - `urls` ContactUrl[]
      - `type` string, required
      - `url` string, required
  - `has_more` boolean, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/close/apis/close-api.md) · [All operations](https://skmtc.net/close/apis/close-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/close/close-api/revisions/0dcf3303e9d7/schema)