---
title: "Get request by ID"
method: GET
path: "/requests/{id}"
tags: ["requests"]
---

# Get request by ID

`GET /requests/{id}`

Returns a request by ID.

## Path parameters

- `id` string, uuid, required

## Response `200`

The requested request object.

- Request — # Request Object ### Description The `Request` object is used to represent a request. ### Usage Example Returned from the `GET Requests` endpoint.
  - `id` string, uuid, required — The unique identifier of the request.
  - `created_at` string, date-time, required — The date and time the request was created.
  - `updated_at` string, date-time, required — The date and time the request was last updated.
  - `requester_id` string, uuid, required — The unique identifier of the user who created the request.
  - `target_user_id` string, uuid — The unique identifier of the user who is the target of the request.
  - `target_group_id` string, uuid — The unique identifier of the group who is the target of the request.
  - `status` 'PENDING' | 'APPROVED' | 'DENIED' | 'CANCELED', required — # Request Status ### Description The `RequestStatus` enum is used to represent the status of a request. ### Usage Example Returned from the `GET Requests` endpoint.
  - `reason` string, required — The reason for the request.
  - `duration_minutes` integer — The duration of the request in minutes.
  - `requested_items_list` RequestedItem[] — The list of targets for the request.
    - `resource_id` string, uuid — The ID of the resource requested.
    - `group_id` string, uuid — The ID of the group requested.
    - `access_level_name` string — The name of the access level requested.
    - `access_level_remote_id` string — The ID of the access level requested on the remote system.
    - `name` string — The name of the target.
    - `remote_id` string — The ID of the target on the remote system.
    - `remote_name` string — The name of the target on the remote system.
  - `custom_fields_responses` RequestCustomFieldResponse[] — The responses given to the custom fields associated to the request
    - `field_name` string, required
    - `field_type` 'SHORT_TEXT' | 'LONG_TEXT' | 'BOOLEAN' | 'MULTI_CHOICE', required — The type of the custom request field.
    - `field_value` union, required
      - string
      - boolean
  - `stages` RequestItemStages — The stages configuration for a request item
    - `requestedRoleName` string — The name of the requested role
    - `requestedItemName` string, required — The name of the requested item
    - `stages` RequestStage[], required — The stages of review for this request
      - `stage` integer, required — The stage number
      - `operator` 'AND' | 'OR', required — The operator to apply to reviewers in a stage
      - `reviewers` RequestReviewer[], required — The reviewers for this stage
        - `id` string, uuid, required — The unique identifier of the reviewer
        - `full_name` string — The user's full name.
        - `status` 'PENDING' | 'APPROVED' | 'REJECTED', required — The status of this reviewer's review
  - `reviewer_stages` union — The configured reviewer stages for every item in this request, or an error message if reviewers could not be loaded
    - RequestReviewerStages[]
      - `access_level_name` string — The name of the access level requested.
      - `access_level_remote_id` string — The ID of the access level requested on the remote system.
      - `item_name` string, required — The name of the requested item
      - `item_id` string, uuid, required — The ID of the resource requested.
      - `stages` RequestStage[], required — The stages of review for this request
        - `stage` integer, required — The stage number
        - `operator` 'AND' | 'OR', required — The operator to apply to reviewers in a stage
        - `reviewers` RequestReviewer[], required — The reviewers for this stage
          - `id` string, uuid, required — The unique identifier of the reviewer
          - `full_name` string — The user's full name.
          - `status` 'PENDING' | 'APPROVED' | 'REJECTED', required — The status of this reviewer's review
    - string

---

[API](https://skmtc.net/opal/apis/opal-api.md) · [All operations](https://skmtc.net/opal/apis/opal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/opal/opal-api/versions/13b58df96d40/schema)