PIpismo
Anti-fraud

Get anti-fraud statistics by document number

Gets anti fraud statistics based on document number.

post/v2/pix/statistics/persons

Request

  • Base URL
    https://sandbox.pismolabs.io/pix-dict
  • URL
    https://sandbox.pismolabs.io/pix-dict/v2/pix/statistics/persons
  • Auth
    HTTP bearer

Headers

Authorizationstring required
Example:Bearer eyJhbGci...IUzUx

Account token - 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

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.

Example request

{
  "document_number": "123412341234"
}

Response

OK

correlation_idstring uuid

The correlation identifier is used to link related API requests and events. The Pismo engineering team can use this to track everything related to a call. If one is not passed, it is automatically generated and returned to the client in a response header.

Example response

{
  "correlation_id": "ea8bc045-9ff7-439f-a318-2e6f974707a5",
  "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"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.