# List documents for a contact

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

## 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/{id}/documents

**List documents for a contact**

Retrieve all available documents for the tenant with their sharing status for this contact

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

**Path parameters:**

| Name | Type | Required | Description |
|---|---|---|---|
| `id` | string | Yes | Contact ID |

**Responses:**

- `200` - Successfully retrieved documents
  - `documents` (array of DocumentWithSharedStatus (object))
    - `id` (string (uuid))
    - `title` (string)
    - `description` (string)
    - `state` (enum: draft | published | archived)
    - `access_level` (enum: public | restricted | requires_nda | internal): Access level required for this document
    - `is_shared` (boolean): Whether this document is currently shared with the contact
    - `file` (string): URL to access the document file
    - `category` (object): Document category information
      - `id` (string)
      - `title` (string)
- `400` - Bad Request - Contact ID is required
- `401` - Unauthorized - invalid or missing token
- `404` - Not Found - Contact not found or access denied
- `500` - Internal server error

**Code samples:**

cURL:

```bash
curl -X GET "https://app.orbiqhq.com/api/v1/contacts/550e8400-e29b-41d4-a716-446655440000/documents" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

```