---
title: "List fraud markers"
method: POST
path: "/v2/pix/fraud-markers/list"
tags: ["Anti-fraud"]
---

# List fraud markers

`POST /v2/pix/fraud-markers/list`

## Request

- Base URL: `https://sandbox.pismolabs.io/pix-dict`
- URL: `https://sandbox.pismolabs.io/pix-dict/v2/pix/fraud-markers/list`
- Auth: HTTP bearer

List fraud markers

## Query parameters

- `useProvider` string

## Request body `*/*`

- ListFraudMarkersRequest
  - `document_number` string, required: A government document number, such as a Social Security number (US) or Cadastro de Pessoas Físicas number (Brazil). Must be numeric with 11-14 digits.
  - `key` string: Value, based on a key's type, used to encrypt Pix key.
  - `date_time_start` string, date-time: Creation datetime. A RFC 3339 date-time value. For example - `2023-04-12T23:20:50.52Z`.
  - `date_time_end` string, date-time: Creation end date time. RFC 3339 date-time value. Must be greater than or equal to `date_time_start`.
  - `limit` integer: Maximum results to return. Default is `20`. Maximum is `200`.

## Response `200`

OK

- ListFraudMarkersResponse
  - `infraction_id` string, uuid: Infraction report ID (UUID)
  - `response_date_time` string, date-time: Response date time. RFC 3339 date-time value.
  - `has_more_elements` boolean: Are there more items?
  - `fraud_markers` ListFraudMarkersObject[]
    - `id` string, uuid, required: Fraud marker ID
    - `document_number` string, required: A government document number, such as a Social Security number (US) or Cadastro de Pessoas Físicas number (Brazil). Must be numeric with 11-14 digits.
    - `fraud_type` 'APPLICATION_FRAUD' | 'MULE_ACCOUNT' | 'SCAMMER_ACCOUNT' | 'OTHER' | 'UNKNOWN', required: Verified fraud type
    - `status` 'REGISTERED' | 'CANCELLED', required: Fraud marker status
    - `key` string: Key to which the fraud marker will be associated. It must be reported, if known
    - `creation_datetime` string, date-time: Date of infraction report creation. RFC 3339 date-time value. For example - `2023-04-12T23:20:50.52Z`.
    - `last_modified_datetime` string, date-time: Date of infraction report modification. RFC 3339 date-time value. For example - `2023-04-12T23:20:50.52Z`.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Resource Not Found
- `429`: Too many requests
- `500`: Internal Server Error
- `502`: Bad Gateway
- `503`: Service Unavailable
- `504`: Gateway Timeout

---

[API](https://skmtc.dev/pismo/apis/instant-payments-pix-management.md) - [All operations](https://skmtc.dev/pismo/apis/instant-payments-pix-management/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/instant-payments-pix-management/revisions/eb540c289547?raw)