# Account API > View balances, deposit funds, and withdraw to bank accounts or wallets registered through the Axiym Dashboard. Product: Account API Guides follow the current API reference (0.3.0) and event reference (0.2.0). Older reference versions are listed separately; the guides are not historical snapshots. Operation references are compact. Follow the linked schemas for field details, or the complete-reference link to retrieve all related definitions in one document. ## Guides and concepts - [Build with the Account API](https://docs.axiym.io/account-api.md): View your organization's Axiym accounts, deposit funds, and withdraw funds to approved external destinations. - [Overview](https://docs.axiym.io/account-api/concepts/overview.md): Deposit funds into Axiym accounts and prepare, confirm, and track withdrawals to active external destinations. - [Accounts and destinations](https://docs.axiym.io/account-api/concepts/accounts-and-destinations.md): Choose the Axiym account and the active address book entry for a deposit or withdrawal. - [Depositing funds](https://docs.axiym.io/account-api/concepts/depositing-funds.md): Retrieve deposit instructions, send funds from an active address book entry, and track the resulting deposit. - [Withdrawal lifecycle](https://docs.axiym.io/account-api/concepts/withdrawal-lifecycle.md): Follow a withdrawal from creation to a terminal outcome. - [Notifications and tracking](https://docs.axiym.io/account-api/concepts/notifications-and-tracking.md): Combine signed events with API reads for reliable state handling. - [Terminology](https://docs.axiym.io/account-api/concepts/terminology.md): Definitions used throughout the Account API documentation. - [Getting Started](https://docs.axiym.io/account-api/integration-guide.md): Build and operate an Account API integration. - [Access Setup](https://docs.axiym.io/account-api/integration-guide/access-setup.md) - [Sandbox testing](https://docs.axiym.io/account-api/integration-guide/sandbox-testing.md): Test Account API withdrawals with coordinated bank scenarios and wallet transfers on testnet. - [Quickstart: Make your first withdrawal](https://docs.axiym.io/account-api/integration-guide/quick-start.md) - [Integrate using AI](https://docs.axiym.io/account-api/integration-guide/integrate-with-ai.md): Use Axiym documentation and an optional integration prompt with your coding agent. - [Select an address book entry](https://docs.axiym.io/account-api/integration-guide/register-external-account.md) - [Deposit funds](https://docs.axiym.io/account-api/integration-guide/deposit-funds.md) - [Create and confirm a withdrawal](https://docs.axiym.io/account-api/integration-guide/create-a-withdrawal.md): Prepare a retry-safe withdrawal, then confirm it to begin execution. - [Track a withdrawal](https://docs.axiym.io/account-api/integration-guide/track-a-withdrawal.md): Follow withdrawal processing with signed events and current API state. - [Reconcile activity](https://docs.axiym.io/account-api/integration-guide/reconcile-activity.md): Join withdrawals, deposits, account movements, events, and external settlement records. - [Authentication](https://docs.axiym.io/account-api/integration-guide/fundamentals/authentication.md): Obtain an OAuth 2.0 access token and authenticate Axiym API requests. - [Common headers](https://docs.axiym.io/account-api/integration-guide/fundamentals/common-headers.md): Use authentication, tracing, idempotency, and content-type headers consistently. - [Idempotency](https://docs.axiym.io/account-api/integration-guide/fundamentals/idempotency.md): Retry state-changing requests without creating duplicate operations. - [Pagination and query parameters](https://docs.axiym.io/account-api/integration-guide/fundamentals/pagination-and-query-parameters.md): Follow cursor-based pages and use list filters without changing resource scope. - [Error handling and retries](https://docs.axiym.io/account-api/integration-guide/fundamentals/error-handling-and-retries.md): Interpret structured API errors and retry only temporary or ambiguous failures. - [Rate limits](https://docs.axiym.io/account-api/integration-guide/fundamentals/rate-limits.md): Pace requests and handle throttling using the response headers. - [Data formats and constants](https://docs.axiym.io/account-api/integration-guide/fundamentals/data-formats-and-constants.md): Store and send identifiers, decimals, currencies, countries, dates, and timestamps correctly. - [Webhooks Overview](https://docs.axiym.io/account-api/webhooks/overview.md) - [Events](https://docs.axiym.io/account-api/webhooks/events.md) - [Webhook Registration and Management](https://docs.axiym.io/account-api/webhooks/registration-management.md) - [Verifying Webhook Signatures](https://docs.axiym.io/account-api/webhooks/verifying-signatures.md) ## API reference 0.3.0 (current) [OpenAPI contract](https://docs.axiym.io/openapi/account-api/0.3.0.yaml) - [Axiym Account API](https://docs.axiym.io/account-api/api-reference/0.3.0.md) - [Get access token](https://docs.axiym.io/account-api/api-reference/0.3.0/auth/oauth/token/post.md): Exchange your OAuth client credentials for an Account API access token. Send the returned token as `Authorization: Bearer ` on subsequent requests. Request the `ACCOUNT` scope. - [List accounts](https://docs.axiym.io/account-api/api-reference/0.3.0/accounts/listAccounts.md): Returns the Axiym accounts available to your organization. Each account holds a balance in one currency. Use the optional filters to narrow the result by currency or account status. - [Get account](https://docs.axiym.io/account-api/api-reference/0.3.0/accounts/getAccount.md): Returns the current balance, currency, payment rail, and status of one Axiym account. - [Get account statement](https://docs.axiym.io/account-api/api-reference/0.3.0/accounts/getAccountStatement.md): Returns posted credits and debits for one account, including opening and closing balances, movement totals, and entries in posting order. **Reconciliation** `openingBalance + totalCredited - totalDebited = closingBalance` Each entry also carries its running balance. Without `from` and `to`, the statement covers the account's full history. - [Get deposit instructions](https://docs.axiym.io/account-api/api-reference/0.3.0/deposits/getDepositInstructions.md): Returns the receiving details needed to deposit funds into one of your Axiym accounts. **Before sending funds** Send funds only from an `ACTIVE` entry in your address book. Third-party accounts cannot be used. **Instruction type** - Bank instructions contain the receiving-bank details and, when present, an account-specific `reference`. Include the reference on the transfer. - Wallet instructions contain the wallet address and blockchain network to use. - [List deposits](https://docs.axiym.io/account-api/api-reference/0.3.0/deposits/listDeposits.md): Returns incoming payments detected for your Axiym accounts. Deposits are accepted only from `ACTIVE` entries in your address book. Use the optional filters to narrow the results by account or deposit status. - [Get deposit](https://docs.axiym.io/account-api/api-reference/0.3.0/deposits/getDeposit.md): Returns one incoming payment, including its current status, credited account, amount, currency, and available bank or blockchain details. - [List address book entries](https://docs.axiym.io/account-api/api-reference/0.3.0/address-book/listAddressBookEntries.md): Returns registered external bank accounts and wallet addresses available as withdrawal destinations. Only an `ACTIVE` entry can receive a withdrawal. Use the optional filters to narrow the result by currency or status. - [Get an address book entry](https://docs.axiym.io/account-api/api-reference/0.3.0/address-book/getAddressBookEntry.md): Returns one registered external bank account or wallet address, including its payment details and current status. Use its `destinationId` when creating a withdrawal after the entry is `ACTIVE`. - [List withdrawals](https://docs.axiym.io/account-api/api-reference/0.3.0/withdrawals/listWithdrawals.md): Returns withdrawals created from your Axiym accounts, including their current execution status. Use the optional filters to narrow the result by source account, status, or `externalReference`. - [Create withdrawal](https://docs.axiym.io/account-api/api-reference/0.3.0/withdrawals/createWithdrawal.md): Creates an outgoing withdrawal from `sourceAccountId` to the address book entry selected by `destinationId`. **Requirements** - The source account and destination must be `ACTIVE`. - They must use the same currency. - `destinationId` must identify a registered address book entry. The response contains the resolved source and destination details and has status `PENDING_CONFIRMATION`. Creation does not begin execution; confirm the returned `withdrawalId` with `POST /withdrawals/{withdrawalId}/confirm`. - [Confirm withdrawal](https://docs.axiym.io/account-api/api-reference/0.3.0/withdrawals/confirmWithdrawal.md): Confirms a withdrawal in `PENDING_CONFIRMATION` status and begins execution. The request has no body. Use the `withdrawalId` returned by `POST /withdrawals` and provide a new `Idempotency-Key` for this confirmation request. - [Get withdrawal](https://docs.axiym.io/account-api/api-reference/0.3.0/withdrawals/getWithdrawal.md): Returns the current state of one withdrawal, including its source account, destination, amounts, fee, and any completed wallet transaction hash. Use this as the authoritative status after creation or confirmation and when processing withdrawal webhooks. - [List webhook subscriptions](https://docs.axiym.io/account-api/api-reference/0.3.0/webhook-subscriptions/webhooks/subscriptions/get.md): Returns the webhook subscriptions registered by your organization. - [Create webhook subscription](https://docs.axiym.io/account-api/api-reference/0.3.0/webhook-subscriptions/webhooks/subscriptions/post.md): Registers an HTTPS endpoint to receive account, address book, and withdrawal notifications. Your endpoint must be publicly reachable and return a `2XX` response to the webhook `POST` request. - [Test webhook subscription](https://docs.axiym.io/account-api/api-reference/0.3.0/webhook-subscriptions/webhooks/subscriptions/subscriptionid/tests/post.md): Sends a test notification to one registered webhook endpoint. - [Disable webhook subscription](https://docs.axiym.io/account-api/api-reference/0.3.0/webhook-subscriptions/webhooks/subscriptions/subscriptionid/delete.md): Disables one webhook subscription so it no longer receives notifications. - [Get webhook public key](https://docs.axiym.io/account-api/api-reference/0.3.0/webhook-subscriptions/webhooks/public-keys/publickeyid/get.md): Returns a public key used to verify webhook signatures. - [Schemas](https://docs.axiym.io/account-api/api-reference/0.3.0/schemas.md): Data models used by the Account API. ## Event reference 0.2.0 (current) [OpenAPI contract](https://docs.axiym.io/openapi/account-api/events/0.2.0.yaml) - [Axiym Account API events](https://docs.axiym.io/account-api/events/0.2.0.md) - [Created](https://docs.axiym.io/account-api/events/0.2.0/withdrawal/onWithdrawalCreated.md) - [Held](https://docs.axiym.io/account-api/events/0.2.0/withdrawal/onWithdrawalHeld.md) - [Completed](https://docs.axiym.io/account-api/events/0.2.0/withdrawal/onWithdrawalCompleted.md) - [Canceled](https://docs.axiym.io/account-api/events/0.2.0/withdrawal/onWithdrawalCanceled.md) - [Rejected](https://docs.axiym.io/account-api/events/0.2.0/withdrawal/onWithdrawalRejected.md) - [Credited](https://docs.axiym.io/account-api/events/0.2.0/account/onAccountCredited.md) - [Debited](https://docs.axiym.io/account-api/events/0.2.0/account/onAccountDebited.md) - [Activated](https://docs.axiym.io/account-api/events/0.2.0/account/onAccountActivated.md) - [Suspended](https://docs.axiym.io/account-api/events/0.2.0/account/onAccountSuspended.md) - [Closed](https://docs.axiym.io/account-api/events/0.2.0/account/onAccountClosed.md) - [Created](https://docs.axiym.io/account-api/events/0.2.0/deposit/onDepositCreated.md): Sent when an incoming payment has been detected and recorded as a deposit. - [Held](https://docs.axiym.io/account-api/events/0.2.0/deposit/onDepositHeld.md): Sent when processing of a deposit has been placed temporarily on hold. - [Completed](https://docs.axiym.io/account-api/events/0.2.0/deposit/onDepositCompleted.md): Sent when a deposit has completed and the receiving account has been credited. - [Canceled](https://docs.axiym.io/account-api/events/0.2.0/deposit/onDepositCanceled.md): Sent when a deposit has been canceled and will not be credited to the receiving account. - [Rejected](https://docs.axiym.io/account-api/events/0.2.0/deposit/onDepositRejected.md): Sent when a deposit has been rejected and will not be credited to the receiving account. - [Created](https://docs.axiym.io/account-api/events/0.2.0/address-book-entry/onDestinationCreated.md) - [Activated](https://docs.axiym.io/account-api/events/0.2.0/address-book-entry/onDestinationActivated.md) - [Suspended](https://docs.axiym.io/account-api/events/0.2.0/address-book-entry/onDestinationSuspended.md) - [Closed](https://docs.axiym.io/account-api/events/0.2.0/address-book-entry/onDestinationClosed.md) - [Webhook subscription test](https://docs.axiym.io/account-api/events/0.2.0/webhook-subscription/onSubscriptionTest.md): Sent only when you request a test delivery for a webhook subscription. - [Schemas](https://docs.axiym.io/account-api/events/0.2.0/schemas.md): Individual event schema definitions.