---
title: "List approval requests"
method: GET
path: "/api/v1/approvals"
tags: ["Approvals"]
---

# List approval requests

`GET /api/v1/approvals`

## Request

- Base URL: `https://dashboard.sealgate.ai`
- URL: `https://dashboard.sealgate.ai/api/v1/approvals`
- Auth: HTTP bearer

List gated approval requests. USER sees their own; ADMIN and OWNER see their domain.

## Query parameters

- `page` integer
- `per_page` integer
- `status` 'pending' | 'approved' | 'denied'

## Response `200`

A page of approval requests

- ApprovalRequestPage
  - `items` ApprovalRequest[], required
    - `id` integer, required: Approval request ID
    - `session_id` string, required: Session that triggered the approval request
    - `tool_name` string, required: Name of the tool requesting approval
    - `tool_params` object, nullable: Parameters passed to the tool
    - `user_id` string, required
    - `user_email` string, nullable
    - `agent_name` string, nullable
    - `trifecta_flags` string[], required
    - `risk` RiskInfo: Plain-language risk explanation for a blocked action.
      - `title` string
      - `headline` string
      - `summary` string
      - `legs` object, nullable: Trifecta legs (private/untrusted/external) with their sources
      - `server_name` string
      - `acl_level` string
      - `risk_level` string, nullable: Severity: low, medium, high, or critical
      - `policy_rule` string, nullable
      - `source` string: How the summary was produced: template or llm
    - `reason` string, nullable: What held the call: 'trifecta'/'trifecta_prevent' or 'policy_approval'
    - `policy_rule` string, nullable
    - `status` string, required: Approval status: pending, approved, denied
    - `created_at` string, date-time, required
  - `total` integer, required
  - `page` integer, required
  - `per_page` integer, required
  - `total_pages` integer, required

## Other responses

- `401`: Missing or invalid API key
- `422`: Request validation failed

---

[API](https://skmtc.dev/sealgate/apis/sealgate-management-api.md) · [All operations](https://skmtc.dev/sealgate/apis/sealgate-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sealgate/apis/sealgate-management-api/revisions/c9ca2e599065?raw)