---
title: "Get requests via Relay"
method: GET
path: "/requests/relay"
tags: ["requests"]
deprecated: true
---

# Get requests via Relay

`GET /requests/relay`

> **Deprecated.**

Returns a paginated list of requests using Relay-style cursor pagination.

## Query parameters

- `first` integer
- `after` string
- `last` integer
- `before` string
- `status` 'PENDING' | 'APPROVED' | 'DENIED' | 'CANCELED' — # Request Status ### Description The `RequestStatus` enum is used to represent the status of a request. ### Usage Example Returned from the `GET Requests` endpoint.
- `to` string, uuid
- `from` string, uuid

## Response `200`

A paginated list of requests using Relay-style cursor pagination.

- RequestConnection
  - `edges` RequestEdge[], required
    - `node` Request, required — # 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
              - …
        - string
    - `cursor` string, required — The cursor for this request edge
  - `pageInfo` PageInfo, required
    - `hasNextPage` boolean, required — Whether there are more items after the end cursor
    - `endCursor` string, required — The cursor to continue pagination forwards
    - `hasPreviousPage` boolean, required — Whether there are more items before the start cursor
    - `startCursor` string, required — The cursor to continue pagination backwards
  - `totalCount` integer, required — The total number of items available

---

[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)