---
title: "Retrieve payout tracking event"
method: GET
path: "/v1/payout_tracking_events/{id}"
tags: ["Payout Tracking Events"]
---

# Retrieve payout tracking event

`GET /v1/payout_tracking_events/{id}`

## Request

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

Retrieves a payout tracking event by ID.

## Path parameters

- `id` string, uuid, required

## Response `200`

The payout tracking event resource

- PayoutTrackingEventResourceDto
  - `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.

## Changes

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

[Operation history](https://skmtc.dev/augustus/apis/ivy-api/changes/v1/payout_tracking_events/:id/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)