# List all access requests

URL: /en/docs/api/v1/access-requests/get
Last Updated: 2026-07-30T21:15:44.915Z

## 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/access-requests

**List all access requests**

Retrieve all access requests for your tenant with detailed contact and document information.  Results are sorted by creation date (newest first) and can be filtered by review status and account.

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

**Query parameters:**

| Name | Type | Required | Description |
|---|---|---|---|
| `review_status` | array of enum: to_review \| in_review \| approved \| rejected | No | Filter by one or more review status values. Can be specified multiple times for multiple statuses. |
| `account_id` | string (uuid) | No | Filter access requests by specific account ID |
| `search` | string | No | Search by contact name, email, or account title |
| `page` | integer | No | Page number for paginated results (1-indexed) |
| `limit` | integer | No | Number of access requests per page when paginating |

**Responses:**

- `200` - Successfully retrieved access requests
  - `access_requests` (array of AccessRequest (object))
    - `id` (string (uuid)): Unique access request identifier
    - `review_status` (enum: to_review | in_review | approved | rejected): Current review status of the request
    - `date_created` (string (date-time)): When the access request was created
    - `date_updated` (string (date-time)): When the access request was last updated
    - `contact` (object): Contact who made the access request
      - `id` (string): Contact identifier
      - `first_name` (string): Contact's first name
      - `last_name` (string): Contact's last name
      - `email` (string (email)): Contact's email address
      - `review_status` (enum: to_review | in_review | approved | rejected): Contact's review status
      - `account` (object): Account this contact belongs to
        - `id` (string): Account identifier
        - `title` (string): Account/company name
        - `review_status` (string): Account's review status
    - `documents` (array of object): Documents requested in this access request
      - `documents_id` (object)
        - `id` (string): Document identifier
        - `title` (string): Document title
        - `description` (string): Document description
        - `access_level` (enum: public | restricted | requires_nda | internal): Access level required for this document
  - `pagination` (object): Pagination metadata when page or limit is provided
    - `page` (integer)
    - `limit` (integer)
    - `total` (integer)
    - `page_count` (integer)

  Example (Successful response with document requests):
  
  ```json
  {
  "access_requests": [
    {
      "id": "req-123",
      "review_status": "to_review",
      "date_created": "2025-01-15T10:00:00Z",
      "date_updated": "2025-01-15T10:00:00Z",
      "contact": {
        "id": "contact-1",
        "first_name": "John",
        "last_name": "Doe",
        "email": "john.doe@acme.com",
        "review_status": "to_review",
        "account": {
          "id": "acc-123",
          "title": "Acme Corporation",
          "review_status": "approved"
        }
      },
      "documents": [
        {
          "documents_id": {
            "id": "doc-1",
            "title": "SOC 2 Type II Report",
            "description": "Annual security audit report",
            "access_level": "restricted"
          }
        },
        {
          "documents_id": {
            "id": "doc-2",
            "title": "ISO 27001 Certificate",
            "description": "Information security certification",
            "access_level": "public"
          }
        }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 64,
    "page_count": 4
  }
}
  ```
- `401` - Unauthorized - invalid or missing authentication token
- `500` - Internal server error
  - `error` (string)

**Code samples:**

cURL:

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

cURL with filters:

```bash
curl -X GET "https://app.orbiqhq.com/api/v1/access-requests?review_status=to_review&review_status=in_review" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```

cURL with pagination:

```bash
curl -X GET "https://app.orbiqhq.com/api/v1/access-requests?page=1&limit=20" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```