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

# Create fraud marker

`POST /v2/pix/fraud-markers`

## Request

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

Creates a fraud marker. 

On PSP timeout, a `202 Accepted` response is returned with a fraud marker ID. The process continues asynchronously and, if it doesn't succeed, a failure event is emitted.

This endpoint generates a <a href="https://developers.pismo.io/events/docs/pix-dict-fraud-marker-registration-1" >Fraud Marker registration event</a> or <a href="https://developers.pismo.io/events/docs/pix-dict-fraud-marker-registration-failure-1">failure event</a>.

## Headers

- `Authorization` string, required
- `Idempotency-Key` string, required

## Request body `*/*`

- FraudMarkerCreationRequest
  - `document_number` string, required: User's tax ID number (CPF or CNPJ) associated with the fraud marker.
  - `fraud_type` 'APPLICATION_FRAUD' | 'MULE_ACCOUNT' | 'SCAMMER_ACCOUNT' | 'OTHER' | 'UNKNOWN', required: Type of fraud. For fraud marking coming from infraction reports closed in API V1, the value `UNKNOWN` will appear.
  - `key` string: Key associated with fraud marker. It must be reported, if known

## Response `201`

OK

- FraudMarkerResponse
  - `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
  - `bacen_creation_datetime` string, date-time, required: Date of infraction report creation. RFC 3339 date-time value. For example - `2023-04-12T23:20:50.52Z`.
  - `bacen_last_modified_datetime` string, date-time, required: Date of infraction report modification. RFC 3339 date-time value. For example - `2023-04-12T23:20:50.52Z`.

## Other responses

- `202`: Accepted. The process will be processed asynchronous and will send a event via SNS when OK
- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `409`: Conflict
- `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)