Pular para o conteúdo principal
GET
/
v1
/
refunds
Listar Devoluções
curl --request GET \
  --url https://plugin-pix-indirect.api.lerian.net/v1/refunds \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Account-Id: <x-account-id>'
{
  "items": [
    {
      "id": "019c96a0-0c53-7a8d-8e29-67971d96d0e3",
      "originalEndToEndId": "E123456789BR1234567890123456789",
      "returnEndToEndId": "D123456789BR1234567890123456789",
      "amount": "100.00",
      "status": "COMPLETED",
      "reason": "FR01",
      "createdAt": "2024-01-15T10:30:00Z"
    }
  ],
  "limit": 10,
  "page": 1,
  "total": 42
}

Autorizações

​
Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Cabeçalhos

​
X-Account-Id
string
obrigatório

Identificador único da Conta do Ledger Midaz (formato UUID).

Parâmetros de consulta

​
page
integer
padrão:1

Número da página para paginação.

Intervalo obrigatório: x >= 1
​
limit
integer
padrão:10

Número máximo de itens por página.

Intervalo obrigatório: 1 <= x <= 100
​
sort_order
enum<string>
padrão:asc

Direção da ordenação: asc ou desc.

Opções disponíveis:
asc,
desc
​
end_to_end
string

Filtra pelo identificador end-to-end da transferência Pix original.

​
status
enum<string>

Filtra pelo status da devolução (CREATED, PENDING, PROCESSING, COMPLETED, FAILED, CANCELLED).

Opções disponíveis:
CREATED,
PENDING,
PROCESSING,
COMPLETED,
FAILED,
CANCELLED
​
type
enum<string>

Filtra pela direção da devolução (CASHOUT ou CASHIN).

Opções disponíveis:
CASHOUT,
CASHIN
​
modified_after
string

Filtrar por registros modificados após este timestamp (formato RFC3339: 2024-01-15T10:30:00Z).

​
modified_before
string

Filtrar por registros modificados antes deste timestamp (formato RFC3339: 2024-01-15T10:30:00Z).

Resposta

Lista de devoluções recuperada com sucesso.

​
items
object[]
​
limit
integer
Exemplo:

10

​
page
integer
Exemplo:

1

​
total
integer
Exemplo:

42