v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

Anti-fraud

Get anti-fraud statistics by document number

Gets anti fraud statistics based on document number.

post/v2/pix/statistics/persons

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.

Request body

document_numberstring

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.

Example request

{
  "document_number": "7777888hh"
}

Response

correlation_idstring

The Correlation identifier field is used to link related API requests and events. The CID can help the Pismo engineering team track everything related to a call. If not passed, a random one is generated. You can find the CID in the response header.

Example response

{
  "correlation_id": "c737895c-8159-4c0c-a92a-a4f8600bff37",
  "person_statistics": {
    "entries": {
      "watermark": "2020-01-17T10:00:00Z"
    },
    "fraud_markers": {
      "application_frauds": {
        "d90": 86,
        "m12": 23,
        "m60": 12
      },
      "distinct_fraud_reporters": {
        "d90": 86,
        "m12": 23,
        "m60": 12
      },
      "mule_accounts": {
        "d90": 86,
        "m12": 23,
        "m60": 12
      },
      "other_frauds": {
        "d90": 86,
        "m12": 23,
        "m60": 12
      },
      "scammer_accounts": {
        "d90": 86,
        "m12": 23,
        "m60": 12
      },
      "total_fraud_transaction_amount": {
        "d90": 86,
        "m12": 23,
        "m60": 12
      },
      "unknown_frauds": {
        "d90": 86,
        "m12": 23,
        "m60": 12
      },
      "watermark": "2020-01-17T10:00:00Z"
    },
    "infraction_reports": {
      "open_reports": 45,
      "open_reports_distinct_reporters": 34,
      "rejected_reports": {
        "d90": 86,
        "m12": 23,
        "m60": 12
      },
      "watermark": "2020-01-17T10:00:00Z"
    },
    "spi": {
      "settlements": {
        "d90": 86,
        "m12": 23,
        "m60": 12
      },
      "watermark": "2020-01-17T10:00:00Z"
    }
  }
}