---
title: "List Approval Requests"
method: GET
path: "/v2/approval-requests"
tags: ["Approval Request API"]
---

# List Approval Requests

`GET /v2/approval-requests`

List all approval requests for a team.

## Query parameters

- `teamId` string — The ID of the team. Required.
- `pageSize` integer — Maximum number of results to return. Default is 1000, maximum is 5000.
- `pageToken` string — Token for pagination. Leave empty for the first request.

## Response `200`

Success

- SvflowPublicapiListApprovalRequestsResponse
  - `data` SvflowPubapimodelsApprovalRequest[]
    - `accessRequestTimeAllocationId` string — **Option: access_request_time_allocation_id** — The ID of the access request time allocation this approval is for. Each time allocation (initial request or extension) has its own approval round.
    - `workflowRunId` string — **Option: workflow_run_id** — The ID of the workflow run this approval is for.
    - `id` string — The ID of the approval request.
    - `result` 'APPROVAL_REQUEST_RESULT_UNSPECIFIED' | 'PENDING' | 'APPROVED' | 'DENIED' | 'TIMEDOUT' | 'CANCELED'
    - `createdAt` string, date-time — A timestamp in RFC 3339 format (e.g., "2025-01-15T01:30:15Z").
    - `updatedAt` string, date-time — A timestamp in RFC 3339 format (e.g., "2025-01-15T01:30:15Z").
    - `approverJustificationMode` string — Controls whether approvers are asked for a justification when deciding. Valid values: "not_requested", "optional", "required", "required_for_approval", "required_for_denial".
  - `nextPageToken` string, nullable — Token for retrieving the next page of results. Empty if no more results.

## Other responses

- `default` — Error

---

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