Get a Pix refund by ID

Returns a single refund scoped to the calling account.

GET /refunds/{id}

Get a Pix refund by ID

cURL

curl --request GET \
  --url https://api.example.com/spi/v1/refunds/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Account-Id: <x-account-id>'

200

{
  "amount": "100.00",
  "createdAt": "2026-05-06T10:45:00Z",
  "id": "019606b1-3b4c-7d8e-9f01-234567890dee",
  "originalEndToEndId": "E12345678202605061030abcdef12345",
  "reasonCode": "MD06",
  "status": "COMPLETED",
  "type": "OUTBOUND",
  "updatedAt": "2026-05-06T10:45:30Z",
  "accountId": "019606a0-1a2b-7c3d-8e4f-567890123abc",
  "deletedAt": "2023-11-07T05:31:56Z",
  "description": "Estorno solicitado pelo pagador",
  "ledger": {
    "destinationOperationId": "019606a5-7f80-7182-3c4d-56789012cdf1",
    "revert": {
      "destinationOperationId": "019606a5-7f80-7182-3c4d-56789012cdf1",
      "sourceOperationId": "019606a5-7f80-7182-3c4d-56789012cdf0",
      "transactionId": "019606a5-7f80-7182-3c4d-56789012cdef"
    },
    "sourceOperationId": "019606a5-7f80-7182-3c4d-56789012cdf0",
    "transactionId": "019606a5-7f80-7182-3c4d-56789012cdef"
  },
  "metadata": {},
  "returnEndToEndId": "D12345678202605061045fedcba54321",
  "feeCharge": {
    "applied": true,
    "calculationType": "LEDGER",
    "fees": [
      {
        "amount": "1.50",
        "feeLabel": "LEDGER_FEE",
        "calculationType": "LEDGER",
        "calculationValue": "<string>",
        "creditAccount": "@fees-pix"
      }
    ],
    "netAmount": "100.00",
    "totalAmount": "1.50"
  }
}

Autorizações

Authorization · string · header · obrigatório

JWT bearer token issued by the identity provider.

Cabeçalhos

X-Account-Id · string · obrigatório

Account UUID

Exemplo:

"019606a1-3b4c-7d8e-9f01-234567890abc"

Parâmetros de caminho

id · string · obrigatório

Refund UUID

Exemplo:

"0196080a-1234-7890-abcd-ef0123456789"

Resposta

200

application/json

OK

amount · string · obrigatório

Exemplo:

"100.00"

createdAt · string<date-time> · obrigatório

Exemplo:

"2026-05-06T10:45:00Z"

id · string · obrigatório

Exemplo:

"019606b1-3b4c-7d8e-9f01-234567890dee"

originalEndToEndId · string · obrigatório

Exemplo:

"E12345678202605061030abcdef12345"

reasonCode · string · obrigatório

Exemplo:

"MD06"

status · string · obrigatório

Exemplo:

"COMPLETED"

type · string · obrigatório

Exemplo:

"OUTBOUND"

updatedAt · string<date-time> · obrigatório

Exemplo:

"2026-05-06T10:45:30Z"

accountId · string

Exemplo:

"019606a0-1a2b-7c3d-8e4f-567890123abc"

deletedAt · string<date-time>

description · string

Exemplo:

"Estorno solicitado pelo pagador"

ledger · object

Show child attributes

metadata · object

Show child attributes

returnEndToEndId · string

Exemplo:

"D12345678202605061045fedcba54321"

feeCharge · object

Fee the ledger reported on the create that moved the refund's money. Absent when no fee answer was recorded for this refund (its ledger create never landed, an error was logged at the time, or the refund was created before fees were read back); {"applied": false} when the ledger reported that no fee was charged; the full object when it charged one. A refund carries no ledger.revert field and needs none here: a FAILED refund that carries feeCharge was reverted first -- every path that writes a refund FAILED after its ledger create landed reverts the debit before marking it (a revert that does not complete leaves the refund PROCESSING), and every other path fails before any create -- so the fee was returned with the amount; applied reports what the create did and the object records the create.

Show child attributes