---
title: "List payout tracking events"
method: GET
path: "/v1/payout_tracking_events"
tags: ["Payout Tracking Events"]
---

# List payout tracking events

`GET /v1/payout_tracking_events`

## Request

- Base URL: `https://api.augustus.com`
- URL: `https://api.augustus.com/v1/payout_tracking_events`
- Auth: HTTP bearer

Returns a paginated list of payout tracking events, newest first.

## Query parameters

- `limit` integer
- `cursor` string
- `payout_id` string, uuid
- `milestone` 'initiated' | 'submitted' | 'sent' | 'failed' | 'returned' | 'accepted' | 'settled' | 'forwarded' | 'credited' | 'rejected' | 'returning' | 'visibility_lost' | 'other'
- `is_terminal` boolean
- `created_at.gte` string, date-time
- `created_at.lte` string, date-time

## Response `200`

List of payout tracking events

- ListPayoutTrackingEventsResponseDto
  - `data` object[], required
    - `id` string, uuid, required: Unique identifier of the tracking event.
    - `type` 'payout_tracking_event', required: Resource type discriminator.
    - `payout_id` string, uuid, required: ID of the payout this event belongs to.
    - `sequence` integer, required: Gap-free counter per payout, in the order Augustus recorded the events. A gap means you missed a recorded event, such as a dropped webhook. A sequence without gaps does not mean every network step was observed.
    - `milestone` 'initiated' | 'submitted' | 'sent' | 'failed' | 'returned' | 'accepted' | 'settled' | 'forwarded' | 'credited' | 'rejected' | 'returning' | 'visibility_lost' | 'other', required: Normalized point in the payout journey. New values may be added.
    - `scope` 'network' | 'end_to_end', required: How far Augustus can follow the payout: end_to_end when the rail confirms the beneficiary credit, network when it only confirms settlement. New values may be added.
    - `source` 'augustus' | 'swift_gpi' | 'other', required: Where Augustus learned this step: augustus for steps Augustus records itself, swift_gpi for SWIFT gpi statuses, other for any other source. New values may be added.
    - `is_terminal` boolean, required: Whether Augustus considers delivery finished. A later event, such as returned, can still follow.
    - `occurred_at` string, date-time, nullable, required: ISO 8601 UTC timestamp when the step happened. Null when the source has no timestamp. Can be out of order with sequence.
    - `created_at` string, date-time, required: ISO 8601 UTC timestamp when Augustus recorded the event.
    - `institution` object, nullable, required: Institution that acted on or reported this step. Null when unknown.
      - `identifier` object, required: Identifier of the institution, typed by scheme.
        - `type` 'bic', required: Identifier scheme. Only bic today.
        - `value` string, required: ISO 9362 Bank Identifier Code (8 or 11 characters).
    - `network_status` object, nullable, required: Raw network status. Null when the step has none.
      - `code` string, required: Status code reported by the network, such as ACSP, ACSC, ACCC or RJCT.
      - `reason_code` string, nullable, required: Reason code for the status, such as G000. Null when the network reports none.
    - `fee` object, nullable, required: Fee deducted at this step. Null when none was reported.
      - `amount` string, required: Fee amount as a string decimal (e.g. "10.00").
      - `currency` string, required: ISO 4217 currency code of the fee.
      - `borne_by` 'debtor' | 'creditor' | 'shared' | 'other', required: Who bears the charges under the payment charge agreement: debtor (OUR), creditor (BEN), shared (SHA), or other for any other agreement. New values may be added.
    - `beneficiary_amount` object, nullable, required: Amount credited to the beneficiary. Set only on a credited event, otherwise null.
      - `amount` string, required: Credited amount as a string decimal (e.g. "100.50").
      - `currency` string, required: ISO 4217 currency code of the credited amount.
    - `status_reason` object, nullable, required: Reason for the current state. Null when none applies.
      - `code` string, required: Normalized reason code assigned by Augustus. New codes may be added.
      - `description` string, required: Explanation of the reason code, written by Augustus.
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required
  - `has_previous` boolean, required
  - `previous_cursor` string, nullable, required

## Changes

- **2026-10-16** `f7ded6c181ab`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/augustus/apis/ivy-api/changes/v1/payout_tracking_events/get.md)

---

[API](https://skmtc.dev/augustus/apis/ivy-api.md) - [All operations](https://skmtc.dev/augustus/apis/ivy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/augustus/apis/ivy-api/revisions/e87bdcac11cc?raw)