---
title: "Get tracking graph [beta]"
method: GET
path: "/v1/pix/funds-recoveries/{funds_recovery_id}/tracking-graph"
tags: ["Funds recovery"]
---

# Get tracking graph [beta]

`GET /v1/pix/funds-recoveries/{funds_recovery_id}/tracking-graph`

Get tracking graphs.

Retrieves the tracking graph that maps the chain of subsequent transactions originated from the dispersion of fraudulent funds.

The graph identifies people, accounts, and transactions involved in the movement of diverted funds.

You can call this endpoint if you are:
 * The funds recovery creator participant
 * Counterparty participants who received related infraction notifications

## Path parameters

- `funds_recovery_id` string, required

## Query parameters

- `useProvider` string

## Response `200`

OK - success

- TrackingGraphResponse
  - `funds_recovery_id` string — Funds recovery identifier. Returned from the [Create funds recovery](https://developers.pismo.io/pismo-docs/reference/post-create-funds-recovery) endpoint.
  - `parameters` TrackingGraphParameters — Graph parameters. Higher values for `min_transaction_amount` and lower values for `max_transactions`,`max_hops`, and `hop_window` generate smaller and faster graphs. The opposite generates larger and more complete graphs.
    - `min_transaction_amount` number, required — Minimum amount in Brazilian reals to include transaction in tracking.
    - `max_transactions` integer, required — Maximum number of transactions to track
    - `hop_window` string, required — The window duration between transactions * `PT30M` - 30 minutes * `PT45M` - 45 minutes * `PT1H` - 1 hour * `PT2H` - 2 hours
    - `max_hops` integer, required — Maxium tracking depth (1-10 layers)
  - `persons` Person[] — Identified people (account holders)
    - `id` string — Person pseudo-identifier (protects CPF/CNPJ)
    - `type` 'LEGAL_PERSON' | 'NATURAL_PERSON' — Person type: * `LEGAL_PERSON` - An actual person with legal rights. * `NATURAL_PERSON` - An entity, such as an organization or company.
    - `created_at` string, date-time — Person record creation date
  - `accounts` Account[] — Identified transactional accounts
    - `id` integer — Account ID
    - `document_number` string — 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.
    - `postal_code` string — Cardholder postal code
  - `transactions` Transaction[] — PIX transactions that compose the graph
    - `id` string — Transaction end-to-end-ID
    - `debtor_account_id` string — Debtor account ID
    - `creditor_account_id` string — Creditor account ID
    - `amount` number — Original transaction amount
    - `refundable_amount` number — Amount available for refund (may be less than original)
    - `settlement_time` string, date-time — Transaction settlement timestamp. RFC 3339 format.
  - `summary` GraphSummary — Graph summary
    - `total_transactions` integer — Total number of transactions in the graph
    - `total_amount` number — Total amount of all transactions
    - `max_hop_reached` integer — Maximum hop depth reached in the graph
  - `created_at` string, date-time — Creation datetime. A RFC 3339 date-time value. For example - `2023-04-12T23:20:50.52Z`.

## Other responses

- `400` — Invalid ID format
- `404` — Funds recovery or tracking graph not found

---

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