v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

Anti-fraud

Get fraud marker

Get fraud marker details

get/v2/pix/fraud-markers/{id}

Path parameters

idstring uuid required

Fraud marker ID generated for a suspected fraudelent transaction.

Headers

Authorizationstring required

Example:Bearer eyJhbGci...IUzUx

Account token - an access token encoded with a Pismo account ID. Tokens can expire quickly, which can result in a <b>401 Unauthorized</b> message.

Response

idstring uuid required

Fraud marker ID

document_numberstring 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

keystring

Key to which the fraud marker will be associated. It must be reported, if known

bacen_creation_datetimestring date-time required

Date of infraction report creation. RFC 3339 date-time value. For example - 2023-04-12T23:20:50.52Z.

bacen_last_modified_datetimestring date-time required

Date of infraction report modification. RFC 3339 date-time value. For example - 2023-04-12T23:20:50.52Z.

Example response

{
  "id": "ea8bc045-9ff7-439f-a318-2e6f974707a5",
  "document_number": "7777888hh",
  "fraud_type": "APPLICATION_FRAUD",
  "status": "REGISTERED",
  "bacen_creation_datetime": "2020-08-13T13:49:03Z",
  "bacen_last_modified_datetime": "2020-08-13T13:49:03Z"
}