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

# List approvals

`GET /api/v1/approvals`

## Request

- Base URL: `http://dobby-ai.com`
- URL: `http://dobby-ai.com/api/v1/approvals`
- Auth: HTTP bearer

Get a list of pending and resolved approvals

## Query parameters

- `status` 'pending' | 'approved' | 'rejected'
- `agent_id` string
- `limit` integer
- `offset` integer

## Response `200`

List of approvals

- object
  - `success` boolean
  - `data` Approval[]
    - `id` string
    - `task_id` string
    - `agent_id` string
    - `agent_name` string
    - `action_type` string
    - `action_description` string
    - `status` 'pending' | 'approved' | 'rejected' | 'expired'
    - `priority` 'low' | 'medium' | 'high' | 'urgent'
    - `created_at` string, date-time
  - `pagination` Pagination
    - `total` integer
    - `limit` integer
    - `offset` integer
    - `has_more` boolean

## Other responses

- `401`: Unauthorized - Missing or invalid authentication
- `403`: Forbidden - Missing required scope
- `429`: Too Many Requests - Rate limit exceeded

---

[API](https://skmtc.dev/dobby-ai/apis/dobby-platform-api.md) · [All operations](https://skmtc.dev/dobby-ai/apis/dobby-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dobby-ai/apis/dobby-platform-api/revisions/398634f0306f?raw)