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

# Create fraud marker

`POST /v2/pix/fraud-markers`

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

## Response `201`

OK

- FraudMarkerResponse
  - `id` string, uuid, required — Fraud marker ID
  - `document_number` string, required — Cardholder government document number. This can be from any document that identifies the cardholder such as a Tax ID, State ID, or driver's license.
  - `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` — Access token is missing or invalid
- `403` — The request has been lost
- `409` — Conflict
- `429` — Too many reqquests
- `500` — Internal Server Error
- `502` — Bad Gateway
- `503` — Service Unavailable
- `504` — Gateway timeout

---

[API](https://skmtc.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/revisions/935b62e16de4/schema)