> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentchain.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# List approval requests

> Returns pending approval requests for the authenticated operator. Filter by decision status (PENDING, APPROVED, DENIED, EXPIRED). Defaults to PENDING. Auto-expires stale approvals past their TTL.



## OpenAPI

````yaml GET /api/v1/approvals
openapi: 3.0.0
info:
  title: AgentChain & PRIOR API
  description: The centralized gateway for the decentralized compute network.
  version: '1.0'
  contact: {}
servers:
  - url: https://api.agentchain.xyz
    description: Production
security: []
tags: []
paths:
  /api/v1/approvals:
    get:
      tags:
        - Approval Queue
      summary: List approval requests
      description: >-
        Returns pending approval requests for the authenticated operator. Filter
        by decision status (PENDING, APPROVED, DENIED, EXPIRED). Defaults to
        PENDING. Auto-expires stale approvals past their TTL.
      operationId: ApprovalController_list
      parameters:
        - name: decision
          required: false
          in: query
          description: >-
            Filter by decision status: PENDING, APPROVED, DENIED, EXPIRED
            (default: PENDING)
          schema:
            type: string
      responses:
        '200':
          description: List of approval requests
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      description: Approval request ID
                    taskId:
                      type: string
                      description: Associated task ID
                    agentId:
                      type: string
                      description: Agent that submitted the action
                    actionType:
                      type: string
                      example: spend_control
                    operation:
                      type: string
                      example: invoice_payment
                    target:
                      type: string
                      description: Counterparty or resource
                    requestedValue:
                      type: number
                      example: 12000
                      nullable: true
                    currency:
                      type: string
                      example: USDC
                      nullable: true
                    triggerPolicy:
                      type: string
                      example: human_approval_threshold
                    triggerReason:
                      type: string
                      example: $12,000 exceeds auto-approve limit of $5,000
                    decision:
                      type: string
                      enum:
                        - PENDING
                        - APPROVED
                        - DENIED
                        - EXPIRED
                    createdAt:
                      type: string
                      format: date-time
                    expiresAt:
                      type: string
                      format: date-time
                      nullable: true
        '401':
          description: Missing or invalid authentication
      security:
        - x-api-key: []
        - bearer: []
components:
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````