Skip to main content
GET
Get a MED fraud marker

Authorizations

Authorization
string
header
required

JWT bearer token issued by the identity provider.

Path Parameters

idMarcacaoFraude
string
required

The fraud-marker GUID.

Example:

"c3d4e5f6-a7b8-9012-cdef-345678901234"

Query Parameters

ispb
string

The ISPB of the direct participant this read is made as. This deployment may act as SEVERAL direct SPI participants - one ISPB each, each with its own JDPI credential - and a fraud marker names no row this deployment holds, so this field is the only thing that says which JD instance to ask. OPTIONAL while it acts as a single participant: omit it and that one answers. REQUIRED once it acts as several - omitted is 422 PIX-0127, and an ISPB this deployment does not act as is 422 PIX-0128. It is ROUTING DATA you supply and guarantee, exactly like payer_ispb on the limits routes: never a credential, never read from a header or a path, and it never widens what your token can reach. Read as the SAME participant that created the marker, or the JD you ask has never heard of it. Sending it empty (ispb=) reads the same as omitting it.

Pattern: ^[0-9]{8}$
Example:

"12345678"

Response

OK

cpfCnpj
string
required

The flagged document.

Example:

"12345678901"

dtHrCriacao
string
required

JDPI creation timestamp (RFC 3339 UTC).

Example:

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

dtHrUltModificacao
string
required

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

Example:

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

idMarcacaoFraude
string
required

Fraud-marker GUID (the natural key).

Example:

"c3d4e5f6-a7b8-9012-cdef-345678901234"

ispb
string
required

ISPB of the creator PSP.

Example:

"12345678"

status
integer<int64>
required

stMarcacaoFraude lifecycle code (0=Registrada, 1=Cancelada).

Example:

0

statusDescription
string
required

Human-readable stMarcacaoFraude label.

Example:

"Registrada"

tpFraude
integer<int64>
required

Fraud-type code (0..4; 4=Desconhecida is read-only).

Example:

1

tpFraudeDescription
string
required

Human-readable tpFraude label.

Example:

"Conta laranja"

tpPessoa
integer<int64>
required

Person-type code (0=Pessoa Fisica, 1=Pessoa Juridica).

Example:

0

tpPessoaDescription
string
required

Human-readable tpPessoa label.

Example:

"Pessoa Fisica"

chave
string

The flagged Pix key, when known.

Example:

"user@example.com"

dictCorrelationId
string

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

Example:

"a7f12465e19f5ca51329479a5bae60c2"

dictReturnedAt
string

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

Example:

"2023-08-16T10:30:05.025Z"

idRelatoInfracao
string

Linked infraction GUID, when the marker was auto-created from a closed infraction.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

ispbRelatoInfracao
string

Linked infraction's PSP ISPB, when infraction-originated.

Example:

"87654321"