# List all contacts

URL: /en/docs/api/v1/contacts/get
Last Updated: 2026-07-30T21:15:44.937Z

## Description
No description available.

## Available Actions
- Execute GET request
- View request parameters
- View response schema
- Get code examples
- Navigate to related topics
- View step-by-step instructions
- Get best practices

## Content
### GET /api/v1/contacts

**List all contacts**

Retrieve all contacts for your tenant, including their review status and account information

**Authentication:** Bearer token (`Authorization: Bearer <token>`)

**Responses:**

- `200` - Successfully retrieved contacts
  - `contacts` (array of Contact (object))
    - `id` (string (uuid))
    - `email` (string (email))
    - `first_name` (string)
    - `last_name` (string)
    - `title` (string)
    - `review_status` (enum: to_review | in_review | approved | cancelled): Review status of the contact
    - `account` (object): Associated account information
    - `tenant` (string): Tenant ID this contact belongs to
    - `documents` (array of object): Documents shared with this contact
      - `documents_id` (string)
    - `access_requests` (array of object): Access requests made by this contact
    - `vendor` (object): Associated vendor record or vendor ID
    - `invitations` (array of object): Invitation records related to this contact
      - `id` (string)
      - `state` (string)
      - `accepted_at` (string (date-time))
      - `date_created` (string (date-time))
      - `date_updated` (string (date-time))
    - `nda_acceptances` (array of ContactNdaAcceptance (object)): Completed NDA acceptances related to this contact. Provider data and file identifiers are omitted from this list response.
      - `id` (string): NDA acceptance identifier
      - `contact` (string): Contact identifier that completed the NDA
      - `state` (string): NDA acceptance state
      - `date_created` (string (date-time)): NDA signature timestamp (ISO-8601)
      - `download_type` (enum: file | docusign): Sanitized source type for the downloadable signed NDA, when available
      - `has_download` (boolean): Whether the signed NDA can be downloaded from the acceptance file endpoint
    - `date_created` (string (date-time)): Contact creation timestamp (ISO-8601)
    - `date_updated` (string (date-time)): Contact last update timestamp (ISO-8601)
    - `custom_fields` (array of object): Custom field values for this contact
      - `id` (string)
      - `template` (object)
      - `value` (object)

  Example (List of contacts with related records):
  
  ```json
  {
  "contacts": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "email": "john.doe@example.com",
      "first_name": "John",
      "last_name": "Doe",
      "title": "Security Manager",
      "review_status": "approved",
      "tenant": "tenant-123",
      "account": {
        "id": "acc-123",
        "title": "Acme Corp"
      },
      "vendor": {
        "id": "vendor-123",
        "title": "Acme Vendor"
      },
      "documents": [
        {
          "documents_id": "doc-123"
        }
      ],
      "access_requests": [
        {
          "id": "req-123"
        }
      ],
      "invitations": [
        {
          "id": "inv-123",
          "state": "pending",
          "date_created": "2026-02-24T10:00:00.000Z"
        }
      ],
      "nda_acceptances": [
        {
          "id": "nda-123",
          "contact": "550e8400-e29b-41d4-a716-446655440000",
          "state": "completed",
          "date_created": "2026-02-26T09:30:00.000Z",
          "download_type": "docusign",
          "has_download": true
        }
      ],
      "date_created": "2026-02-20T10:00:00.000Z",
      "date_updated": "2026-02-25T12:00:00.000Z",
      "custom_fields": [
        {
          "id": "cf-123",
          "template": "template-123",
          "value": "Primary security contact"
        }
      ]
    }
  ]
}
  ```
- `401` - Unauthorized - invalid or missing token
- `500` - Internal server error

**Code samples:**

cURL:

```bash
curl -X GET "https://app.orbiqhq.com/api/v1/contacts" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

```