> ## Documentation Index > Fetch the complete documentation index at: https://docs.augustus.com/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Treat the published Augustus OpenAPI specification (https://app.stainless.com/api/spec/documented/augustus/openapi.documented.yml) and the current API-reference pages as the source of truth for endpoints, request/response schemas, enum values, webhook event names, and required headers. > Prefer the 2026-05-01 Banking API and @augustusbank/typescript-sdk for all new integrations. The 2023-01-01 API is a separate, older surface covering two products — Open Banking (instant bank transfer) checkout and refunds, and Manual Bank Transfer (MBT); use it only when one of those products is specifically required. > Cite or link the relevant docs.augustus.com page when answering integration questions. > Do not infer support for currencies, networks, scopes, account types, or operations that are not present in the current documentation. > Use the sandbox base URL (https://api.sandbox.augustus.com) and placeholder credentials in examples. Never include or request a real API key. > The Augustus docs MCP server (https://docs.augustus.com/mcp) provides documentation search and retrieval only; it does not execute authenticated Augustus API actions. # deposit.received > A deposit has been received ## OpenAPI ````yaml https://api.getivy.de/openapi/webhooks/json post /api/service/webhook-event/deposit.received openapi: 3.0.0 info: title: Ivy Webhook Events description: Ivy Webhook Events schema version: '1.0' contact: name: Ivy url: https://www.getivy.io email: help@getivy.io servers: [] security: [] tags: [] paths: /api/service/webhook-event/deposit.received: post: tags: - WebhookEventExamples - Deposit summary: deposit.received description: A deposit has been received operationId: WebhookEventExamplesController_depositReceived parameters: [] requestBody: required: true description: Data of the webhook event content: application/json: schema: $ref: '#/components/schemas/DepositReceivedWebhookEventDto' responses: '200': description: OK servers: - url: https://{yourDomain} variables: yourDomain: description: The URL where you want to receive webhook events default: www.your-domain.com components: schemas: DepositReceivedWebhookEventDto: type: object properties: id: description: The unique id for the webhook. type: string type: type: string enum: - deposit.received date: description: The date of the webhook. type: string payload: description: The received deposit data. type: object properties: id: description: The ID of the deposit type: string format: uuid status: description: The status of the deposit type: string enum: - received amount: description: The amount of the deposit type: number transactionId: type: string currency: description: The currency of the deposit type: string enum: - EUR - GBP - PLN - SEK - DKK - USD - USDC - BTC - ETH - SOL - POL receivedAt: {} payer: description: The payer account identifier type: object properties: type: type: string enum: - iban - sort_code - bank_code - bban - wallet - aba x-enumNames: - IBAN - SORT_CODE - BANK_CODE - BBAN - WALLET - ABA iban: type: object properties: accountHolderName: type: string minLength: 1 iban: type: string bic: type: string required: - accountHolderName - iban aba: type: object properties: accountHolderName: type: string minLength: 1 routingNumber: type: string pattern: ^[0-9]+$ accountNumber: type: string pattern: ^[0-9]+$ required: - accountHolderName - routingNumber - accountNumber sortCode: type: object properties: accountHolderName: type: string minLength: 1 sortCode: type: string pattern: ^[0-9]+$ accountNumber: type: string pattern: ^[0-9]+$ maxLength: 8 required: - accountHolderName - sortCode - accountNumber bankCode: type: object properties: accountHolderName: type: string minLength: 1 code: type: string accountNumber: type: string required: - accountHolderName - code - accountNumber bban: type: object properties: accountHolderName: type: string minLength: 1 bban: type: string bic: type: string required: - accountHolderName - bban wallet: type: object properties: address: description: The blockchain wallet address type: string blockchain: description: The blockchain network type: string enum: - BTC - BTC-TESTNET4 - ETH - ETH-SEPOLIA - SOL - SOL-DEVNET - MATIC - MATIC-AMOY required: - address - blockchain required: - type payee: description: The payee account identifier type: object properties: type: type: string enum: - iban - sort_code - bank_code - bban - wallet - aba x-enumNames: - IBAN - SORT_CODE - BANK_CODE - BBAN - WALLET - ABA iban: type: object properties: accountHolderName: type: string minLength: 1 iban: type: string bic: type: string required: - accountHolderName - iban aba: type: object properties: accountHolderName: type: string minLength: 1 routingNumber: type: string pattern: ^[0-9]+$ accountNumber: type: string pattern: ^[0-9]+$ required: - accountHolderName - routingNumber - accountNumber sortCode: type: object properties: accountHolderName: type: string minLength: 1 sortCode: type: string pattern: ^[0-9]+$ accountNumber: type: string pattern: ^[0-9]+$ maxLength: 8 required: - accountHolderName - sortCode - accountNumber bankCode: type: object properties: accountHolderName: type: string minLength: 1 code: type: string accountNumber: type: string required: - accountHolderName - code - accountNumber bban: type: object properties: accountHolderName: type: string minLength: 1 bban: type: string bic: type: string required: - accountHolderName - bban wallet: type: object properties: address: description: The blockchain wallet address type: string blockchain: description: The blockchain network type: string enum: - BTC - BTC-TESTNET4 - ETH - ETH-SEPOLIA - SOL - SOL-DEVNET - MATIC - MATIC-AMOY required: - address - blockchain required: - type bankStatementReference: type: string rail: description: The payment rail or blockchain used for the deposit type: string enum: - sepa_instant - faster_payments - sepa - elixir - express_elixir - sek_account_to_account - sumclearing - straksclearing - swift - internal - target - ach - fedwire - BTC - BTC-TESTNET4 - ETH - ETH-SEPOLIA - SOL - SOL-DEVNET - MATIC - MATIC-AMOY txHash: description: The transaction hash for crypto deposits type: string returns: type: array items: type: object properties: id: description: The ID of the return type: string format: uuid depositId: description: The ID of the associated deposit type: string format: uuid transactionId: description: The ID of the resulting return transaction type: string format: uuid status: description: The status of the return type: string enum: - initiated - succeeded - failed - returned x-enumNames: - Initiated - Succeeded - Failed - Returned amount: description: The amount of the return type: number currency: description: The currency of the return type: string enum: - EUR - GBP - PLN - SEK - DKK - USD - USDC - BTC - ETH - SOL - POL createdAt: description: The date and time the return was created type: string format: date-time failedAt: description: The date and time the return failed if applicable type: string format: date-time succeededAt: description: The date and time the return succeeded if applicable type: string format: date-time required: - id - depositId - status - amount - currency - createdAt depositId: description: 'Deprecated: use id instead' type: string value: type: object properties: currency: description: 'Deprecated: use currency instead' type: string amount: description: 'Deprecated: use amount instead' type: string required: - currency - amount required: - id - status - amount - transactionId - currency - receivedAt - payer - payee - returns - depositId - value required: - id - type - date - payload ````