---
title: "Get anti-fraud statistics by key"
method: POST
path: "/v2/pix/statistics/keys"
tags: ["Anti-fraud"]
---

# Get anti-fraud statistics by key

`POST /v2/pix/statistics/keys`

## Request

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

Gets anti fraud statistics based on key.

## Headers

- `Authorization` string, required

## Request body

- AntifraudStatisticsSearchByKeyRequest
  - `key` string: Value, based on a key's type, used to encrypt Pix key.

## Response `200`

OK

- AntifraudStatisticsSearchByKey
  - `correlation_id` string, 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.
  - `key_statistics` EntryKeyStatistics
    - `entries` EntryEntriesKey
      - `distinct_accounts` EntryDetails: Event counters.
        - `d90` integer: Events occurring in last 90 days counter.
        - `m12` integer: Events occurring in last 12 months counter.
        - `m60` integer: Events occurring in last 60 months counter.
      - `watermark` string, date-time: Last anti-fraud event's date and time. RFC 3339 format.
    - `fraud_markers` EntryFraudMarkersKey
      - `application_frauds` EntryDetails: Event counters.
        - `d90` integer: Events occurring in last 90 days counter.
        - `m12` integer: Events occurring in last 12 months counter.
        - `m60` integer: Events occurring in last 60 months counter.
      - `distinct_fraud_reporters` EntryDetails: Event counters.
        - `d90` integer: Events occurring in last 90 days counter.
        - `m12` integer: Events occurring in last 12 months counter.
        - `m60` integer: Events occurring in last 60 months counter.
      - `mule_accounts` EntryDetails: Event counters.
        - `d90` integer: Events occurring in last 90 days counter.
        - `m12` integer: Events occurring in last 12 months counter.
        - `m60` integer: Events occurring in last 60 months counter.
      - `other_frauds` EntryDetails: Event counters.
        - `d90` integer: Events occurring in last 90 days counter.
        - `m12` integer: Events occurring in last 12 months counter.
        - `m60` integer: Events occurring in last 60 months counter.
      - `scammer_accounts` EntryDetails: Event counters.
        - `d90` integer: Events occurring in last 90 days counter.
        - `m12` integer: Events occurring in last 12 months counter.
        - `m60` integer: Events occurring in last 60 months counter.
      - `total_fraud_transaction_amount` EntryDetails: Event counters.
        - `d90` integer: Events occurring in last 90 days counter.
        - `m12` integer: Events occurring in last 12 months counter.
        - `m60` integer: Events occurring in last 60 months counter.
      - `unknown_frauds` EntryDetails: Event counters.
        - `d90` integer: Events occurring in last 90 days counter.
        - `m12` integer: Events occurring in last 12 months counter.
        - `m60` integer: Events occurring in last 60 months counter.
      - `watermark` string, date-time: Last anti-fraud event's date and time. RFC 3339 format.
    - `infraction_reports` EntryInfractionReportsKey
      - `rejected_reports` EntryDetails: Event counters.
        - `d90` integer: Events occurring in last 90 days counter.
        - `m12` integer: Events occurring in last 12 months counter.
        - `m60` integer: Events occurring in last 60 months counter.
      - `open_reports` integer: Number of infringement notifications not yet completed or cancelled.
      - `open_reports_distinct_reporters` integer: Number of distinct participants creating infringement notifications that have not yet been completed or cancelled.
      - `watermark` string, date-time: Last anti-fraud event's date and time. RFC 3339 format.
    - `spi` EntrySpi: Data on settlements
      - `settlements` EntryDetails: Event counters.
        - `d90` integer: Events occurring in last 90 days counter.
        - `m12` integer: Events occurring in last 12 months counter.
        - `m60` integer: Events occurring in last 60 months counter.
      - `watermark` string, date-time: Last anti-fraud event's date and time. RFC 3339 format.
  - `owner_statistics` EntryOwnerStatistics
    - `entries` EntryEntriesOwner
      - `registered_accounts` integer: Number of owner's accounts associated with currently registered keys.
      - `watermark` string, date-time: Last anti-fraud event's date and time. RFC 3339 format.
    - `fraud_markers` EntryFraudMarkersOwner
      - `application_frauds` EntryDetails: Event counters.
        - `d90` integer: Events occurring in last 90 days counter.
        - `m12` integer: Events occurring in last 12 months counter.
        - `m60` integer: Events occurring in last 60 months counter.
      - `distinct_fraud_reporters` EntryDetails: Event counters.
        - `d90` integer: Events occurring in last 90 days counter.
        - `m12` integer: Events occurring in last 12 months counter.
        - `m60` integer: Events occurring in last 60 months counter.
      - `mule_accounts` EntryDetails: Event counters.
        - `d90` integer: Events occurring in last 90 days counter.
        - `m12` integer: Events occurring in last 12 months counter.
        - `m60` integer: Events occurring in last 60 months counter.
      - `other_frauds` EntryDetails: Event counters.
        - `d90` integer: Events occurring in last 90 days counter.
        - `m12` integer: Events occurring in last 12 months counter.
        - `m60` integer: Events occurring in last 60 months counter.
      - `scammer_accounts` EntryDetails: Event counters.
        - `d90` integer: Events occurring in last 90 days counter.
        - `m12` integer: Events occurring in last 12 months counter.
        - `m60` integer: Events occurring in last 60 months counter.
      - `total_fraud_transaction_amount` EntryDetails: Event counters.
        - `d90` integer: Events occurring in last 90 days counter.
        - `m12` integer: Events occurring in last 12 months counter.
        - `m60` integer: Events occurring in last 60 months counter.
      - `unknown_frauds` EntryDetails: Event counters.
        - `d90` integer: Events occurring in last 90 days counter.
        - `m12` integer: Events occurring in last 12 months counter.
        - `m60` integer: Events occurring in last 60 months counter.
      - `watermark` string, date-time: Last anti-fraud event's date and time. RFC 3339 format.
    - `infraction_reports` EntryInfractionReportsOwner
      - `open_reports` integer: Number of infringement notifications not yet completed or cancelled.
      - `open_reports_distinct_reporters` integer: Number of distinct participants creating infringement notifications that have not yet been completed or cancelled.
      - `rejected_reports` EntryDetails: Event counters.
        - `d90` integer: Events occurring in last 90 days counter.
        - `m12` integer: Events occurring in last 12 months counter.
        - `m60` integer: Events occurring in last 60 months counter.
      - `watermark` string, date-time: Last anti-fraud event's date and time. RFC 3339 format.
    - `spi` EntrySpi: Data on settlements
      - `settlements` EntryDetails: Event counters.
        - `d90` integer: Events occurring in last 90 days counter.
        - `m12` integer: Events occurring in last 12 months counter.
        - `m60` integer: Events occurring in last 60 months counter.
      - `watermark` string, date-time: Last anti-fraud event's date and time. RFC 3339 format.

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error
- `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)
