> ## Documentation Index > Fetch the complete documentation index at: https://www.papers.bot/docs/llms.txt > Use this file to discover all available pages before exploring further. # List recent approval requests > Returns requests newest first with cursor pagination (default 25, maximum 100 per page). Credentials can read their own requests; owner/admin sessions can review workspace requests. ## OpenAPI ````yaml /openapi.json get /approvals openapi: 3.1.0 info: title: Papers API version: 0.1.0 description: >- Email, SMS, and workspace resources for Papers. Authenticate resource requests with a scoped API key or OAuth token. Administrative endpoints require a human session. servers: - url: https://www.papers.bot/v1 security: - bearerAuth: [] paths: /approvals: get: tags: - Approvals summary: List recent approval requests description: >- Returns requests newest first with cursor pagination (default 25, maximum 100 per page). Credentials can read their own requests; owner/admin sessions can review workspace requests. operationId: listApprovals parameters: - name: cursor in: query schema: type: string - name: limit in: query schema: type: integer minimum: 1 maximum: 100 default: 25 responses: '200': description: Successful JSON response content: application/json: schema: $ref: '#/components/schemas/ApprovalPage' '429': description: >- Request rate limit or communication quota exceeded. Rate-limit responses include Retry-After. headers: Retry-After: description: >- Seconds until the request-rate window resets (rate_limited errors) schema: type: integer minimum: 1 maximum: 60 content: application/json: schema: $ref: '#/components/schemas/Error' default: description: Request rejected content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: ApprovalPage: $schema: https://json-schema.org/draft/2020-12/schema type: object properties: policyVersion: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 data: type: array items: type: object properties: id: type: string minLength: 1 principalId: type: string minLength: 1 route: type: string resourceId: type: string minLength: 1 parameters: anyOf: - type: object properties: attachments: type: array items: type: object properties: filename: type: string contentType: type: string size: type: integer minimum: 0 maximum: 9007199254740991 required: - filename - contentType - size additionalProperties: false from: type: string to: type: array items: type: string subject: type: string text: type: string required: - from - to - subject - text additionalProperties: false - type: object properties: to: type: string text: type: string attachments: type: array items: type: object properties: filename: type: string contentType: type: string size: type: integer minimum: 0 maximum: 9007199254740991 required: - filename - contentType - size additionalProperties: false required: - to - text additionalProperties: false - type: object properties: name: type: string username: type: string address: type: string agentId: type: string minLength: 1 required: - username - address additionalProperties: false - type: object properties: phoneNumber: type: string country: type: string monthlyCost: type: string upfrontCost: type: string currency: type: string agentId: type: string minLength: 1 required: - phoneNumber - country - monthlyCost - upfrontCost - currency additionalProperties: false status: type: string enum: - pending - approved - denied - consumed expiresAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ policyVersion: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 decidedAt: anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ - type: 'null' operationId: anyOf: - type: string minLength: 1 - type: 'null' createdAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ required: - id - principalId - route - resourceId - parameters - status - expiresAt - policyVersion - decidedAt - operationId - createdAt additionalProperties: false nextCursor: anyOf: - type: string minLength: 1 - type: 'null' required: - policyVersion - data - nextCursor additionalProperties: false Error: $schema: https://json-schema.org/draft/2020-12/schema type: object properties: error: type: object properties: code: type: string message: type: string request_id: type: string retryable: type: boolean details: anyOf: - type: object properties: approvalId: type: string minLength: 1 required: - approvalId additionalProperties: false - type: array items: type: object properties: code: type: string path: type: array items: type: - string - number message: type: string required: - code - path - message additionalProperties: false required: - code - message - request_id - retryable additionalProperties: false required: - error additionalProperties: false securitySchemes: bearerAuth: type: http scheme: bearer description: >- Workspace API key or delegated OAuth access token with /v1 resource audience. Administrative routes require the Better Auth browser session instead. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.