Skip to navigation
API ReferenceAccounts

Get account by ID

Retrieve details of a specific Mercury account by ID, including balances and routing information.

Authentication

AuthorizationBearer

Bearer token authentication for Mercury API.

Use your API token in the Authorization header: Authorization: Bearer TOKEN

Example: Authorization: Bearer secret-token:mercury_production_wma_24SCp4G81X3yHL4Wq8FgzuaP9ye3VKf2mgTDctXyRg5HY_yrucrem

Your Mercury API token should include the ‘secret-token:’ prefix. Tokens can be generated from your Mercury dashboard settings.

Path parameters

accountIdstringRequiredformat: "uuid"

Response

accountNumberstring
The bank account number.
availableBalancedouble
Available balance in USD.
createdAtstringformat: "yyyy-mm-ddThh:MM:ssZ"
Timestamp when the account was created.
currentBalancedouble
Current balance in USD, including pending transactions.
idstringformat: "uuid"
Unique identifier for the Mercury account.
kindstring

Account classification (e.g., checking, savings).

legalBusinessNamestring
Legal business name associated with this account.
namestring
Account display name in the Mercury dashboard.
routingNumberstring
The routing number for ACH and wire transfers.
statusenum

Account lifecycle status (active, pending, deleted, archived).

Allowed values:
typeenum
The product type of the account.
Allowed values:
canReceiveTransactionsboolean or nullOptional
Whether this account can receive incoming transactions.
nicknamestring or nullOptional

User-defined nickname for the account.

Errors

404
Not Found Error