---
title: "deposit.settled"
method: POST
path: "deposit.settled"
tags: ["Webhook Events"]
---

# deposit.settled

`POST deposit.settled` (webhook)

Sent when a deposit is settled

## Payload

- object
  - `id` string, required: Unique identifier for the event. Stable across retries.
  - `type` 'deposit.settled', required: Event type in resource.action format.
  - `api_version` string, required: API version the payload was rendered at. Stable across retries and redeliveries.
  - `payload` DepositResourceDto, required
    - `id` string, uuid, required: Unique identifier of the deposit.
    - `type` 'deposit', required: Resource type discriminator.
    - `status` 'settled', required: Current status of the deposit.
    - `account_id` string, uuid, required: ID of the account that was credited with the deposit.
    - `amount` string, required: Amount as a string decimal (e.g. "100.50").
    - `currency` 'EUR' | 'GBP' | 'USD' | 'USDC', required: Currency code (ISO 4217 or crypto).
    - `counterparty_id` string, uuid, nullable, required: ID of the counterparty that sent the money, or null when not known.
    - `unstructured_remittance_information` string, nullable, required: Unstructured remittance information attached to the transfer. Not all rails support this field.
    - `tracking_reference` object, nullable, required: Rail network tracking identifier with its type: UETR for SWIFT, IMAD for Fedwire, or the 15-digit trace number for ACH. Null when unavailable.
      - `type` 'uetr' | 'imad' | 'trace_number', required: Tracking reference type: UETR, IMAD, or ACH trace number.
      - `value` string, required: Rail-provided tracking identifier.
    - `rail` 'sepa' | 'sepa_instant' | 'faster_payments' | 'swift' | 'internal' | 'target' | 'ach' | 'fedwire' | 'bitcoin' | 'bitcoin_testnet4' | 'ethereum' | 'ethereum_sepolia' | 'solana' | 'solana_devnet' | 'polygon' | 'polygon_amoy' | 'null', nullable, required: Payment scheme or blockchain used for the deposit, or null when unknown.
    - `tx_hash` string, nullable, required: Transaction hash for crypto deposits, or null when not known. Only blockchain rails support this field.
    - `returns` string[], required: Array of deposit return IDs associated with this deposit.
    - `settled_at` string, date-time, required: ISO 8601 UTC timestamp when the deposit was settled.
  - `date` string, date-time, required: ISO 8601 UTC timestamp when the event was created.

## Acknowledgement `200`

Event received successfully.

---

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