---
title: "Returns a paginated list of requests, optionally filtered by status, type, and last-updated time."
method: GET
path: "/api/v1/Requests"
tags: ["Requests"]
---

# Returns a paginated list of requests, optionally filtered by status, type, and last-updated time.

`GET /api/v1/Requests`

## Query parameters

- `requestStatuses` RequestStatus[]
- `requestTypes` RequestType[]
- `updatedAfter` string, date-time
- `cursor` string

## Headers

- `X-API-SECRET` string, required — API Secret is used to verify the integrity of the request and authenticate the client. It should be included in all requests. This value must be kept confidential and should never be exposed in client-side code or public repositories.

## Response `200`

OK

- RequestSimplifiedViewModelV1PaginatedResponseViewModel — Paginated response for a list of entities and pagination-related links.
  - `data` RequestSimplifiedViewModelV1[], required — The list of entities in the current page of the result.
    - `id` string, uuid, required — Unique identifier of the request.
    - `requestType` string, required — Type of the request.
    - `requestStatus` string, required — Current status of the request.
    - `requestedByUserId` string, uuid, required — ID of the user who created the request.
    - `cancelledByUserId` string, uuid, nullable — ID of the user who cancelled the request, if applicable.
    - `workAppId` string, uuid, required — ID of the associated Work App.
    - `permissionLevelId` string, uuid, nullable — ID of the associated permission level, if applicable.
    - `targetUserId` string, uuid, nullable — ID of the target user, if applicable.
    - `requestPurpose` string, nullable — Purpose or reason for the request.
    - `sourceId` string, uuid, required — ID of the source entity related to the request.
    - `sourceName` string, required — Name of the source entity related to the request.
    - `createdAt` string, date-time, required — Timestamp when the request was created.
    - `updatedAt` string, date-time, required — Timestamp when the request was last updated.
  - `links` LinksViewModel, required — Pagination-related URLs for navigating a paginated collection.
    - `self` string, required — URL to the current resource or page.
    - `next` string, nullable — URL to the next page in the collection, if available.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/cakewalk/apis/cakewalk-open-api.md) · [All operations](https://skmtc.net/cakewalk/apis/cakewalk-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cakewalk/cakewalk-open-api/revisions/5728f183a29d/schema)