Pular para o conteúdo principal
GET
Get a MED value recovery

Autorizações

Authorization
string
header
obrigatório

JWT bearer token issued by the identity provider.

Parâmetros de caminho

idRecValores
string
obrigatório

The value-recovery GUID.

Exemplo:

"b2c3d4e5-f6a7-8901-bcde-f23456789012"

Parâmetros de consulta

ispb
string

The ISPB of the direct participant this request acts for. OPTIONAL: omit it and the request is answered exactly as before. Named, the record has to be one that participant is a party to - either side of a dispute, the creator of a value recovery, the participant a refund credit was booked for - or the answer is 404 PIX-0147 and nothing is read from JDPI or changed. A record this deployment does not hold is 404 PIX-0147 too when an ispb is named. An ISPB this deployment does not act as is 422 PIX-0128, before any record is read. It is ROUTING DATA you supply, never a credential, and a token confined to one participant has to name it here. Sending it empty (ispb=) reads the same as omitting it.

Pattern: ^[0-9A-Z]{8}$
Exemplo:

"12345678"

indirectId
string<uuid>

The registered indirect participant (UUID) this request acts for. OPTIONAL: omit it and the request is answered exactly as before. Named, the value recovery has to be over a root payment this deployment recorded for that indirect - the rule GET /v1/med/recoveries/awaiting-return?indirectId= lists by - or the answer is 404 PIX-0147 and nothing is read from JDPI or changed; a record this deployment does not hold is 404 PIX-0147 too when an indirectId is named. It is ROUTING DATA you supply, never a credential, and a token confined to one indirect has to name it here. Not a valid UUID is 400 PIX-0061. Sending it empty (indirectId=) reads the same as omitting it.

Exemplo:

"3f2504e0-4f89-41d3-9a0c-0305e82c3301"

Resposta

OK

breached
boolean
obrigatório

True when the return deadline has been reached or passed (computed at read time); false when no deadline is set.

Exemplo:

false

contactEmail
string
obrigatório

Creator-contact email.

Exemplo:

"ops@example.com"

contactPhone
string
obrigatório

Creator-contact phone.

Exemplo:

"+5511999999999"

createdAt
string
obrigatório

JDPI creation timestamp (RFC 3339 UTC).

Exemplo:

"2024-01-01T12:00:00.000Z"

creatorIspb
string
obrigatório

ISPB of the recovery creator.

Exemplo:

"12345678"

idTransacaoRaiz
string
obrigatório

EndToEndId of the root transaction being recovered.

Exemplo:

"E1234567820240101000000000000001"

recoveryId
string
obrigatório

Value-recovery GUID (the natural key).

Exemplo:

"b2c3d4e5-f6a7-8901-bcde-f23456789012"

situationType
integer<int64>
obrigatório

Situation code (0..5).

Exemplo:

0

situationTypeDescription
string
obrigatório

Human-readable situationType label.

Exemplo:

"Golpe/Estelionato"

status
integer<int64>
obrigatório

stRecValores lifecycle code (0=created .. 6=cancelled).

Exemplo:

0

statusDescription
string
obrigatório

Human-readable stRecValores label.

Exemplo:

"Criada"

updatedAt
string
obrigatório

JDPI last-modification timestamp (RFC 3339 UTC) — the watermark.

Exemplo:

"2024-01-01T12:05:00.000Z"

details
string

Free-text detail (required when situationType=4 Outros).

Exemplo:

"Suspected scam."

dictCorrelationId
string

idCorrelacao — the DICT support identifier for this consultar call; quote it to JD when disputing whether the read happened.

Exemplo:

"a9f13566e19f5ca51329479a5bae60c5"

dictReturnedAt
string

dtHrRetornoDict — when DICT answered this consultar (contract 2.21).

Exemplo:

"2025-08-27T10:30:05.025Z"

returnDeadline
string

Creator-side 72h return deadline (RFC 3339 UTC; contract §2.22/§5), from the analysis stage close; null unless this institution is the creatorIspb on an analyzed recovery.

Exemplo:

"2024-01-04T12:00:00.000Z"