> ## 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. # Retrieve a payout > Retrieve a payout object by id. ## OpenAPI ````yaml https://app.stainless.com/api/spec/documented/getivy/openapi.documented.yml post /api/service/payout/retrieve openapi: 3.0.0 info: title: Ivy API description: Ivy API schema version: '1.0' contact: name: Ivy url: https://www.getivy.io email: help@getivy.io servers: - url: https://api.getivy.de description: Production - url: https://api.sand.getivy.de description: Sandbox security: [] tags: [] paths: /api/service/payout/retrieve: post: tags: - Payout summary: Retrieve a payout description: Retrieve a payout object by id. operationId: PayoutController_retrieve parameters: [] requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/RetrieveDto' responses: '200': description: Retrieve a payout content: application/json: schema: $ref: '#/components/schemas/RetrieveResponseDto' security: - ApiKeyAuth: [] x-codeSamples: - lang: JavaScript source: |- import Ivy from '@getivy/node-sdk'; const client = new Ivy({ apiKey: process.env['IVY_API_KEY'], // This is the default and can be omitted }); const payout = await client.payouts.retrieve({ id: 'id' }); console.log(payout.id); components: schemas: RetrieveDto: type: object properties: id: description: The payout ID type: string required: - id RetrieveResponseDto: type: object properties: id: description: The payout ID type: string type: description: The payout type type: string enum: - beneficiary - customer destination: description: The payout destination 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 status: description: The payout status type: string enum: - paid - pending - in_transit - failed - canceled x-enumNames: - Paid - Pending - InTransit - Failed - Canceled amount: description: The payout amount type: number currency: description: The payout currency type: string enum: - EUR - GBP - USDC - USD metadata: description: The payout metadata type: object additionalProperties: {} createdAt: description: The payout created at updatedAt: description: The payout updated at paymentReference: description: The payout payment reference type: string transactionId: description: The payout transaction ID type: string failure: description: Failure details. Only available if the payout failed. type: object properties: code: description: >- Failure code. Please refer to the documentation for the list of possible values. type: string enum: - account_closed - account_blocked - insufficient_funds - invalid_account_format - invalid_instruction - invalid_amount - invalid_time - duplicate_transaction - payee_verification_failed - system_error - provider_system_error - rejected_by_correspondent_bank - blocked_by_review - unknown x-enumNames: - ACCOUNT_CLOSED - ACCOUNT_BLOCKED - INSUFFICIENT_FUNDS - INVALID_ACCOUNT_FORMAT - INVALID_INSTRUCTION - INVALID_AMOUNT - INVALID_TIME - DUPLICATE_TRANSACTION - PAYEE_VERIFICATION_FAILED - SYSTEM_ERROR - PROVIDER_SYSTEM_ERROR - REJECTED_BY_CORRESPONDENT_BANK - BLOCKED_BY_REVIEW - UNKNOWN message: description: Human readable description of the failure. type: string retry: description: If true, you can safely retry. type: boolean required: - code - message - retry required: - id - type - destination - status - amount - currency - createdAt - updatedAt securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-Ivy-Api-Key description: API key for authentication ````