> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # List Refunds > Use this endpoint to list refunds with optional filters and pagination. ## OpenAPI ````yaml /pt/openapi/v3-current/indirect-pix.yaml get /v1/refunds openapi: 3.1.0 info: contact: email: contact@lerian.studio name: Lerian Studio url: https://lerian.studio description: >- API for Pix Indirect via BTG. It covers DICT keys and claims; MED infraction reports, fraud markers, refund requests, and funds recoveries; DICT statistics and reconciliation; Pix transfers, refunds, and schedules; static QR codes and QR code decoding; immediate and due-date collections; Pix Automático for the payer; transaction reports and TemposTransacoes statistics; and inbound and outbound webhook records. license: name: Lerian Studio General License title: Pix BTG API version: 1.14.0 servers: - url: https://api.example.com description: >- Replace the example host with the URL provided during environment onboarding. security: - BearerAuth: [] paths: /v1/refunds: get: tags: - Refunds summary: List Refunds description: Use this endpoint to list refunds with optional filters and pagination. operationId: payment-list-refunds parameters: - description: Account ID (UUID format) in: header name: X-Account-Id required: true schema: description: Account ID (UUID format) type: string - description: 'Page number for pagination (default: 1)' explode: false in: query name: page schema: description: 'Page number for pagination (default: 1)' type: string - description: 'Maximum number of items per page (default: 10, range: 1-100)' explode: false in: query name: limit schema: description: 'Maximum number of items per page (default: 10, range: 1-100)' type: string - description: 'Sort direction for results: asc or desc' explode: false in: query name: sort_order schema: description: 'Sort direction for results: asc or desc' type: string - description: Filter by the original Pix transfer end-to-end identifier explode: false in: query name: end_to_end schema: description: Filter by the original Pix transfer end-to-end identifier type: string - description: >- Filter by refund status; comma-separated for multiple (OR-matched), e.g. PENDING,COMPLETED. Allowed: CREATED, PENDING, PROCESSING, COMPLETED, REJECTED, FAILED, CANCELLED explode: false in: query name: status schema: description: >- Filter by refund status; comma-separated for multiple (OR-matched), e.g. PENDING,COMPLETED. Allowed: CREATED, PENDING, PROCESSING, COMPLETED, REJECTED, FAILED, CANCELLED type: string - description: Filter by refund direction (CASHOUT or CASHIN) explode: false in: query name: type schema: description: Filter by refund direction (CASHOUT or CASHIN) type: string - description: Filter by refunds modified after this timestamp (RFC3339) explode: false in: query name: modified_after schema: description: Filter by refunds modified after this timestamp (RFC3339) type: string - description: Filter by refunds modified before this timestamp (RFC3339) explode: false in: query name: modified_before schema: description: Filter by refunds modified before this timestamp (RFC3339) type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/RefundsListOutput' description: OK '400': content: application/json: schema: $ref: '#/components/schemas/LegacyErrorBody' description: Bad Request '500': content: application/json: schema: $ref: '#/components/schemas/LegacyErrorBody' description: Internal Server Error default: content: application/json: schema: $ref: '#/components/schemas/LegacyErrorBody' description: Error components: schemas: RefundsListOutput: additionalProperties: false properties: items: items: $ref: '#/components/schemas/RefundCashoutOutput' type: array limit: examples: - 10 format: int64 type: integer page: examples: - 1 format: int64 type: integer total: examples: - 42 format: int64 type: integer required: - items - page - limit - total type: object LegacyErrorBody: additionalProperties: false properties: code: type: string fields: additionalProperties: type: string type: object headers: additionalProperties: type: string type: object message: type: string paths: additionalProperties: type: string type: object queryParams: additionalProperties: type: string type: object raw: type: string title: type: string required: - code - title - message type: object RefundCashoutOutput: additionalProperties: false properties: accountId: examples: - 01989f9e-6508-79f8-9540-835be49fbd0d type: string amount: examples: - '100.50' type: string createdAt: examples: - '2024-01-15T10:30:00Z' type: string deletedAt: type: string description: examples: - Customer reported unauthorized transaction type: string id: examples: - 550e8400-e29b-41d4-a716-446655440001 type: string ledger: $ref: '#/components/schemas/LedgerInfo' metadata: additionalProperties: {} type: object originalEndToEndId: examples: - E12345678202411241430ABCDEFGHIJK type: string returnEndToEndId: examples: - D3030629420200808185300887639654 type: string status: enum: - CREATED - PENDING - PROCESSING - COMPLETED - REJECTED - FAILED - CANCELLED examples: - PENDING type: string type: enum: - CASHOUT - CASHIN examples: - CASHOUT type: string updatedAt: examples: - '2024-01-15T10:30:00Z' type: string required: - id - originalEndToEndId - returnEndToEndId - amount - status - type - accountId - createdAt - updatedAt type: object LedgerInfo: additionalProperties: false properties: destinationOperationId: examples: - 550e8400-e29b-41d4-a716-446655440013 type: string revert: $ref: '#/components/schemas/LedgerRevertInfo' sourceOperationId: examples: - 550e8400-e29b-41d4-a716-446655440012 type: string transactionId: examples: - 550e8400-e29b-41d4-a716-446655440011 type: string type: object LedgerRevertInfo: additionalProperties: false properties: destinationOperationId: examples: - 550e8400-e29b-41d4-a716-446655440016 type: string sourceOperationId: examples: - 550e8400-e29b-41d4-a716-446655440015 type: string transactionId: examples: - 550e8400-e29b-41d4-a716-446655440014 type: string type: object securitySchemes: BearerAuth: bearerFormat: JWT description: JWT bearer token issued by the identity provider. scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.