1. Accounts
Artha Api's
  • Introduction
  • Authentication
  • KYC/KYB Requirements
  • API Setup Guide
  • Products
    • List Products
      GET
    • Get Product
      GET
    • Get Customer Product Status
      GET
  • Customers
    • Create Customer
      POST
    • List Customers
      GET
    • Get Customer
      GET
    • Submit Applicant
      POST
    • Create Onboarding Session
      POST
  • Wallets
    • Beneficiary
      • Create Crypto Beneficiary
      • Update Crypto Beneficiary
      • List Crypto Withdraw Beneficiaries
    • Create Wallet
      POST
    • Get Wallet Address
      GET
    • Get Customer Balances
      GET
    • List Wallets
      GET
    • List Withdrawals
      GET
    • List Withdrawal Networks
      GET
    • Preview Withdrawal Summary
      POST
    • Create Crypto Withdrawal
      POST
  • Cards
    • Issuance
      • Issue Card
      • List Cards
      • List Customer Cards
      • Get Card Details
      • Get Sensitive Card Details
    • Funding
      • Top Up Card
      • Get Card Balance
      • Get Top-Up Status
      • List Top-Up History
    • Operations
      • Resend Activation Code
      • Activate Card
      • Set Card PIN
      • Change Card PIN
      • Update Card Limits
      • Freeze Card
      • Unfreeze Card
      • Replace Card
      • Cancel Card
      • Get Card Limits
      • Show Card PIN Details
      • Get PIN View Iframe URL
      • Get PIN Change Iframe URL
      • Get PIN Set Iframe URL
      • Get Card View Iframe URL
      • Show Card PIN
  • Payees
    • Create a payee for a customer.
    • List a customer's payees.
    • Update a payee.
    • Retrieve a payee by id.
    • Look up an existing payee.
    • List the currencies a payee can be created in.
    • List the accepted payment purpose codes for a payee.
    • List the countries a payee can be created in.
    • List currency/country pairings for payees.
    • List the accepted beneficiary relationship codes.
  • Payments
    • Onboarding
      • List the customer's payout-currency configuration sections.
      • Enable a payout-currency section for the customer.
      • Get the customer's terms-of-service acceptance status.
      • Enable or disable a payout-currency section.
    • Quote
      • List the currencies a beneficiary can be paid in under a product.
      • List the payout rails available for a product and beneficiary.
      • Create an FX quote giving the rate and fee for a cross-currency payout.
    • Order
      • Submit a payout order to send money to a beneficiary.
      • Retrieve the on-chain address to fund an order.
      • Retrieve the status and settlement detail of a payout order.
    • Lookups
      • List the accepted payment purpose codes for a payout.
      • List the accepted source-of-funds codes for a payout.
      • List the document types accepted on a payout order.
  • Banks
    • Accounts
      • Create Bank Account
        POST
      • Get Account Details
        GET
      • Get Account Issuance Status
        GET
    • Withdraw
      • Create Withdrawal Quote
      • List Withdrawal Purposes
      • Get Payment Schemes
      • Execute Withdrawal
  • Exchange
    • Quote
      • Get Exchange Rate
      • Create Price Quote
    • Order
      • Place Exchange Order
  • Transactions
    • List Transactions
    • Get Transaction Details
  • Utilities
    • List Currencies
    • List Countries
    • List Product Occupations
    • List Product Industry Codes
    • Upload File
  • Webhook's
    • Wallets Webhooks
    • Banks Webhooks
    • Payments Webhooks
    • Exchange Webhooks
    • Card Webhooks
  1. Accounts

Get Account Details

GET
/baseurl/api/v1/accountissuance/account/{accountId}
Returns the full details of a single bank account, including banking coordinates (IBAN, account number, routing code, SWIFT/BIC) once the account is active. Use it after issuance to retrieve the details you share with the account holder.
Prerequisites
The account must have been created via POST /api/v1/accountissuance/accounts.
The account must belong to a customer of your platform — cross-platform lookups return 404.
Notes
Banking coordinates (iban, accountNumber, swiftRouteBICNumber, routingCode, bankName) may be null while the account is still pending.
If you only need the status, prefer the lighter GET /api/v1/accountissuance/{accountId}/status endpoint for polling.
Status values
StatusMeaning
PendingBeing provisioned
ApprovedDone — banking details available
RejectedIssuance failed
📤 Response Fields
FieldTypeNullableDescription
data.accountIdstring (uuid)NoAccount ID
data.productIdstring (uuid)NoProduct the account was issued against
data.customerIdstring (uuid)NoOwning customer
data.currencystringNoISO-4217 currency code
data.statestringNoPending | Approved | Rejected
data.accountNumberstringYesLocal account number
data.ibanstringYesIBAN, where applicable
data.swiftRouteBICNumberstringYesSWIFT/BIC code of the partner bank
data.accountHolderNamestringNoName of the account holder
data.bankNamestringYesPartner bank holding the account
data.routingCodestringYesRouting code (e.g. ABA number)
data.routingTypestringYesRouting code type (e.g. ABA)
data.sortCodestringYesUK sort code, if applicable
data.minLimitnumberNoMinimum transaction limit
data.maxLimitnumberNoMaximum transaction limit
data.banksDetailsobjectYesPartner bank address (Address Line1, City, State, Postal Code, Country)

Request

Path Params

Header Params

Responses

🟢200
application/json
Account details returned.
Bodyapplication/json

🟠401
🟠404
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/baseurl/api/v1/accountissuance/account/8e5f183f-545e-4c96-9876-e0c90d3fd2d5' \
--header 'X-API-Key: ak_live_8f3a9b2c1d4e5f6a7b8c' \
--header 'X-Signature: q2h8Zx0kPz5mVw7Yb3Nc1Rt6Ue9Ia4Od2Sf8Gk0Jl4=' \
--header 'X-Timestamp: 1754812800' \
--header 'X-Nonce: f47ac10b-58cc-4372-a567-0e02b2c3d479' \
--header 'X-Body-Hash: 47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU='
Response Response Example
200 - Success
{
    "accountId": "8e5f183f-545e-4c96-9876-e0c90d3fd2d5",
    "productId": "b0d056de-f0d5-43c5-85c2-840810af208b",
    "customerId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "currency": "USD",
    "state": "Approved",
    "accountNumber": "9880050634723967898",
    "iban": "9880050634723967898",
    "swiftRouteBICNumber": "SSBAUS32",
    "accountHolderName": "Hanako Sato",
    "bankName": "Slovak Savings Bank",
    "routingCode": "043087080",
    "routingType": "ABA",
    "sortCode": null,
    "minLimit": 0,
    "maxLimit": 0,
    "banksDetails": {
        "Address Line1": "8700 Perry Highway",
        "City": "Pittsburgh",
        "State": "PA",
        "Postal Code": "15237",
        "Country": "US"
    }
}
Modified at 2026-11-17 05:52:50
Previous
Create Bank Account
Next
Get Account Issuance Status
Built with