---
title: "Get PIX client statistics"
method: GET
path: "/v2/pix/statistics"
tags: ["Anti-fraud"]
---

# Get PIX client statistics

`GET /v2/pix/statistics`

Retrieve client account aggregated PIX statistics from BACEN DICT. 

**Statistics include:**

- **SPI settlements**: count of settlements over the last 90 days, 12 months, and 60 months
- **Fraud markers**: categorized fraud report counts (application frauds, mule accounts, scammer accounts, etc.)
- **Infraction reports**: open reports, distinct reporters, and rejected reports counts
- **Entries**: number of registered accounts linked to the client

Statistics are pre-computed and cached. Use `force_update=true` to trigger a fresh
computation from BACEN DICT.

## Query parameters

- `force_update` boolean

## Headers

- `Authorization` string, required

## Response `200`

OK

- StatisticGetClientStatisticsResponse
  - `person_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

- `401` — Access token is missing or invalid
- `403` — The request has been lost
- `429` — Too many reqquests
- `500` — Internal Server Error

---

[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)