---
title: "Search Approval Requests"
method: POST
path: "/v2/approval-requests/search"
tags: ["Approval Request API"]
---

# Search Approval Requests

`POST /v2/approval-requests/search`

Search approval requests with filters such as resource type, result status, and date range.

## Request body

- SvflowPublicapiSearchApprovalRequestsRequest
  - `teamId` string — The ID of the team. Required.
  - `resourceType` 'APPROVAL_REQUEST_RESOURCE_TYPE_UNSPECIFIED' | 'APPROVAL_REQUEST_RESOURCE_TYPE_ACCESS_ALLOCATION' | 'APPROVAL_REQUEST_RESOURCE_TYPE_WORKFLOW_RUN'
  - `results` SvflowCommonModelsApprovalRequestResult[] — Filter by result statuses (multiple allowed).
  - `createdAfter` string, nullable — Filter by requests created after this timestamp (RFC3339 format).
  - `createdBefore` string, nullable — Filter by requests created before this timestamp (RFC3339 format).
  - `pageSize` integer, nullable — Maximum number of results to return. Default is 1000, maximum is 5000.
  - `pageToken` string, nullable — Token for pagination. Leave empty for the first request.

## Response `200`

Success

- SvflowPublicapiSearchApprovalRequestsResponse
  - `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)