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.

GET /dict/fraud-markers

cURL with fictitious data

cURL

curl --request GET \
  --url https://api.example.com/dict-hub/v1/dict/fraud-markers?tax_id_number=12345678901 \
  --header 'Authorization: Bearer demo-access-token'

200

{
  "fraudMarkers": [],
  "hasMoreElements": false,
  "total": 1
}

Authorizations

Authorization · string · header · required

JWT bearer token issued by the identity provider.

Query Parameters

tax_id_number · string · required

CPF (11 digits) or numeric CNPJ (14 digits) to filter by

Example:

"12345678901"

key · string

Optional Pix key filter. Maximum 77 BYTES UTF-8, not characters -- see CreateFraudMarkerBody.Key.

Example:

"[e-mail]"

status · enum<string>

Optional status filter

Available options: REGISTERED, CANCELLED

Example:

"REGISTERED"

modified_after · string<date-time>

Optional RFC 3339 lower bound on lastModified

Example:

"2026-08-01T00:00:00Z"

modified_before · string<date-time>

Optional RFC 3339 upper bound on lastModified

Example:

"2026-08-19T23:59:59Z"

limit · string

Optional page size, 1..200

Example:

"50"

Response

200

application/json

Matching fraud markers (possibly empty).

fraudMarkers · object[] · required

Matching fraud markers, empty when none match

Show child attributes

Example:

[]

hasMoreElements · boolean · required

Whether more results exist beyond this page

Example:

false

total · integer<int64> · required

Total number of matching fraud markers

Example:

1