List fraud markers
Returns the fraud markers registered for the required tax_id_number within the participant scope determined by the authenticated tenant. Optional filters are key, status (REGISTERED or CANCELLED), modified_after and modified_before (RFC3339), and limit (1 to 200). limit has no default and is applied only when provided. The listing serves only a numeric CPF or CNPJ: an alphanumeric CNPJ passes validation and is then refused with 400 / PIX-0020. total is the number of markers in this page, not a count of every match; hasMoreElements says whether more markers match.
Authorizations
JWT bearer token issued by the identity provider.
Query Parameters
CPF or CNPJ (numeric or alphanumeric per IN RFB 2.229/2024) to filter by, checked against BACEN/RFB check digits. Mask, surrounding whitespace, and lowercase are accepted and normalized to the canonical unformatted uppercase form before use.
"12345678901"
Optional Pix key filter. Maximum 77 BYTES UTF-8, not characters -- see CreateFraudMarkerBody.Key.
"user@example.com"
Optional status filter
REGISTERED, CANCELLED "REGISTERED"
Optional RFC 3339 lower bound on lastModified
"2026-08-01T00:00:00Z"
Optional RFC 3339 upper bound on lastModified
"2026-08-19T23:59:59Z"
Optional page size, 1..200
"50"
Response
Matching fraud markers (possibly empty).
Matching fraud markers, empty when none match
Whether more results exist beyond this page
false
Number of fraud markers in this page. It is not a count of every match: BACEN returns none, and hasMoreElements says whether more markers match.
1

