Skip to main content
POST
Simulate an incoming deposit

Authorizations

Authorization
string
header
required

Bearer token for authentication with Augustus Banking API

Headers

Idempotency-Key
string
required

Idempotency key for safe retries. Reusing a key with an identical request body returns the cached response. Reusing a key with a different body returns 409.

Body

application/json

Incoming deposit simulation parameters

account_id
string<uuid>
required

ID of the account to credit with the simulated deposit.

amount
string
required

Amount as a decimal string in the account currency (e.g. "100.50").

Pattern: ^(0|[1-9]\d*)(\.\d+)?$
currency
enum<string>
required

Currency of the simulated deposit.

Available options:
EUR,
GBP,
USD,
USDC
Example:

"EUR"

unstructured_remittance_information
string

Unstructured remittance information attached to the transfer. Not all rails support this field.

Minimum string length: 1
counterparty
object

Sender of the simulated deposit. Mutually exclusive with counterparty_id.

counterparty_id
string<uuid>

ID of an existing counterparty to use as the sender of the simulated deposit. Mutually exclusive with counterparty.

rail
enum<string>

Payment rail the simulated deposit arrives on.

Available options:
sepa,
sepa_instant,
faster_payments,
swift,
ach,
fedwire,
ethereum,
ethereum_sepolia,
solana,
solana_devnet,
polygon,
polygon_amoy

Response

200 - application/json

The deposit simulation acknowledgement

type
enum<string>
required

Resource type discriminator.

Available options:
deposit_simulation
account_id
string<uuid>
required

Account receiving the simulated deposit.