> ## 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 linked to a funds recovery > Lists the refunds associated with a funds recovery within the scope of the participant determined by the authenticated tenant. {id} is the funds recovery resource ID. The recovery must belong to the requesting participant. ## OpenAPI ````yaml en/openapi/v3-current/pix-lerian-dict.yaml GET /dict/funds-recoveries/{id}/refunds openapi: 3.1.0 info: contact: name: Lerian Studio url: https://lerian.studio description: >- Public API for Pix keys, claims, fraud markers, infraction reports, and MED funds recovery. license: name: Elastic License 2.0 url: https://www.elastic.co/licensing/elastic-license title: Pix Lerian — DICT version: release-candidate servers: - url: https://api.example.com/dict-hub/v1 description: >- Replace the example host with the URL provided during environment onboarding. security: - BearerAuth: [] tags: - description: Register, retrieve, list, update, and remove Pix keys. name: Entries - description: Look up Pix keys and check whether keys exist in the DICT directory. name: Keys - description: Manage ownership and portability claims for Pix keys. name: Claims - description: Manage participant-scoped MED 2.0 funds recoveries. name: Funds Recoveries - description: Manage MED 2.0 infraction reports for the authenticated organization. name: Infraction Reports - description: Create, query, cancel, and settle MED 2.0 refunds. name: Refunds - description: Create, query, list, and cancel DICT fraud markers. name: Fraud Markers paths: /dict/funds-recoveries/{id}/refunds: get: tags: - Funds Recoveries summary: List refunds linked to a funds recovery description: >- Lists the refunds associated with a funds recovery within the scope of the participant determined by the authenticated tenant. {id} is the funds recovery resource ID. The recovery must belong to the requesting participant. operationId: listFundsRecoveryRefunds parameters: - description: Funds recovery internal ID (UUID format) in: path name: id required: true schema: description: Funds recovery internal ID (UUID format) examples: - 018f8c1d-1234-7abc-9def-000000000001 type: string example: 01960718-a213-2435-6078-901234567123 responses: '200': content: application/json: schema: $ref: '#/components/schemas/ListRefundsOutput' examples: fictitiousExample: summary: Fictitious example value: hasMore: false items: - analysisDetails: Refund accepted after fraud confirmation. analysisResult: TOTALLY_ACCEPTED bacenFundsRecoveryId: 9f3a8b7e-2c1d-4e5a-8b6f-1a2b3c4d5e6f bacenRefundId: a1b2c3d4-e5f6-4789-8abc-1234567890ab contestedParticipant: '12345678' creationTime: '2026-06-15T12:00:00Z' effectiveRefundedAmount: '1500.00' infractionReportId: c3d4e5f6-a7b8-4901-abcd-34567890abcd lastModified: '2026-06-16T09:30:00Z' monitorAccount: false refundAccount: accountNumber: '1234567' accountType: CACC branch: '0001' participant: '12345678' taxIdNumber: '12345678900' refundAmount: '1500.00' refundDetails: Funds returned to the contested account. refundReason: FRAUD refundRejectionReason: NO_BALANCE refundTransactionId: D1234567820260102120012345678901 requestingParticipant: '87654321' status: CLOSED transactionId: E1234567820260101120012345678901 limit: 10 page: 1 total: 0 description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error x-codeSamples: - lang: bash label: cURL with fictitious data source: |- curl --request GET \ --url https://api.example.com/dict-hub/v1/dict/funds-recoveries/01960718-a213-2435-6078-901234567123/refunds \ --header 'Authorization: Bearer demo-access-token' components: schemas: ListRefundsOutput: additionalProperties: false properties: hasMore: examples: - false type: boolean items: items: $ref: '#/components/schemas/RefundOutput' type: - array - 'null' limit: examples: - 10 format: int64 type: integer page: examples: - 1 format: int64 type: integer total: examples: - 0 format: int64 type: integer required: - items - total - page - limit - hasMore type: object Detail: additionalProperties: false properties: code: description: >- Stable, machine-readable domain error code scoped to the emitting service (format: -NNNN). examples: - ERR-0001 type: string detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string upstream: $ref: '#/components/schemas/Upstream' description: >- RFC 9457 extension member: the error a proxied third-party provider reported. Absent unless the emitting service explicitly surfaced one. type: object RefundOutput: additionalProperties: false properties: analysisDetails: examples: - Refund accepted after fraud confirmation. type: string analysisResult: enum: - TOTALLY_ACCEPTED - PARTIALLY_ACCEPTED - REJECTED examples: - TOTALLY_ACCEPTED type: string bacenFundsRecoveryId: examples: - 9f3a8b7e-2c1d-4e5a-8b6f-1a2b3c4d5e6f type: string bacenRefundId: examples: - a1b2c3d4-e5f6-4789-8abc-1234567890ab type: string contestedParticipant: examples: - '12345678' type: string creationTime: examples: - '2026-06-15T12:00:00Z' type: string effectiveRefundedAmount: examples: - '1500.00' type: string infractionReportId: examples: - c3d4e5f6-a7b8-4901-abcd-34567890abcd type: string lastModified: examples: - '2026-06-16T09:30:00Z' type: string monitorAccount: examples: - false type: boolean refundAccount: $ref: '#/components/schemas/RefundAccountOutput' refundAmount: examples: - '1500.00' type: string refundDetails: examples: - Funds returned to the contested account. type: string refundReason: enum: - FRAUD - OPERATIONAL_FLAW - REFUND_CANCELLED - PIX_AUTOMATICO examples: - FRAUD type: string refundRejectionReason: enum: - NO_BALANCE - ACCOUNT_CLOSURE - INVALID_REQUEST - OTHER - PARTICIPANT_EXCLUSION examples: - NO_BALANCE type: string refundTransactionId: examples: - D1234567820260102120012345678901 type: string requestingParticipant: examples: - '87654321' type: string status: enum: - OPEN - CLOSED - CANCELLED examples: - CLOSED type: string transactionId: examples: - E1234567820260101120012345678901 type: string required: - bacenRefundId - bacenFundsRecoveryId - refundReason - refundAmount - status - transactionId - contestedParticipant - requestingParticipant - monitorAccount - creationTime - lastModified type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object Upstream: additionalProperties: false properties: code: description: The upstream provider's own error code, verbatim. examples: - E4001 type: string message: description: >- The upstream provider's own error message, verbatim (bounded, never its raw response body). examples: - account not found at provider type: string type: object RefundAccountOutput: additionalProperties: false properties: accountNumber: examples: - '1234567' type: string accountType: enum: - CACC - TRAN - SLRY - SVGS - OTHR examples: - CACC type: string branch: examples: - '0001' type: string participant: examples: - '12345678' type: string taxIdNumber: examples: - '12345678900' type: string required: - taxIdNumber - participant - branch - accountNumber - accountType type: object securitySchemes: BearerAuth: bearerFormat: JWT description: JWT bearer token issued by the identity provider. scheme: bearer type: http ````