# Get access request

Source: https://docs.orbiqhq.com/docs/api/v1/access-requests/id/get

### GET /api/v1/access-requests/{id}

**Get access request**

Retrieve an access request with its contact, the contact's account and the requested documents.

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

**Path parameters:**

| Name | Type | Required | Description |
|---|---|---|---|
| `id` | string (uuid) | Yes | Access request ID |

**Responses:**

- `200` - Access request details
  - `access_request` (AccessRequest (object))
    - `id` (string)
    - `review_status` (enum: to_review | in_review | approved | partially_approved | rejected)
    - `date_created` (string (date-time))
    - `date_updated` (string (date-time))
    - `tenant` (string)
    - `contact` (object)
      - `id` (string)
      - `first_name` (string)
      - `last_name` (string)
      - `email` (string (email))
      - `title` (string)
      - `review_status` (string)
      - `account` (object)
        - `id` (string)
        - `title` (string)
        - `description` (string)
        - `domain` (string)
    - `documents` (array of object): Documents requested by the contact
      - `documents_id` (object)
        - `id` (string)
        - `title` (string)
        - `description` (string)
        - `access_level` (string)
        - `file` (string)
- `401` - Unauthorized. The bearer token or session is missing, invalid or expired.
  - `error` (string, required): Human-readable error message
  - `code` (string): Machine-readable error code. Known values: invalid_input, invalid_id, unauthenticated, forbidden, not_found, method_not_allowed, conflict, unsupported_media_type, unprocessable, rate_limited, service_unavailable, internal_error. The set is open: treat any code you don't recognise as a generic error.
  - `param` (string): Request parameter the error refers to, when there is one.
  - `details` (string): Human-readable error details
- `404` - Not found. The access request does not exist, belongs to another tenant or is not visible to you.
  - `error` (string, required): Human-readable error message
  - `code` (string): Machine-readable error code. Known values: invalid_input, invalid_id, unauthenticated, forbidden, not_found, method_not_allowed, conflict, unsupported_media_type, unprocessable, rate_limited, service_unavailable, internal_error. The set is open: treat any code you don't recognise as a generic error.
  - `param` (string): Request parameter the error refers to, when there is one.
  - `details` (string): Human-readable error details
- `500` - Internal server error
  - `error` (string, required): Human-readable error message
  - `code` (string): Machine-readable error code. Known values: invalid_input, invalid_id, unauthenticated, forbidden, not_found, method_not_allowed, conflict, unsupported_media_type, unprocessable, rate_limited, service_unavailable, internal_error. The set is open: treat any code you don't recognise as a generic error.
  - `param` (string): Request parameter the error refers to, when there is one.
  - `details` (string): Human-readable error details
- `503` - Service unavailable. A backend service could not be reached; retry the request later.
  - `error` (string, required): Human-readable error message
  - `code` (string): Machine-readable error code. Known values: invalid_input, invalid_id, unauthenticated, forbidden, not_found, method_not_allowed, conflict, unsupported_media_type, unprocessable, rate_limited, service_unavailable, internal_error. The set is open: treat any code you don't recognise as a generic error.
  - `param` (string): Request parameter the error refers to, when there is one.
  - `details` (string): Human-readable error details

**Code samples:**

cURL:

```bash
curl "https://app.orbiqhq.com/api/v1/access-requests/a50e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

```
