1. Accounts
Artha All Module 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 (KYC/KYB)
      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
    • Get Fee Schedule
    • 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
/api/v1/accountissuance/account/{accountId}
Returns the full details of a single bank account, including banking coordinates (IBAN / account number) once the account is active.
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, bankName, bic) are 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 — fetch full details
rejectedIssuance failed
Related endpoints: POST /api/v1/accountissuance/accounts · GET /api/v1/accountissuance/{accountId}/status

📤 Response Fields
FieldTypeNullableDescription
data.idstring (uuid)NoAccount ID
data.customerIdstring (uuid)NoOwning customer
data.productIdstring (uuid)NoProduct the account was issued against
data.statusstringNopending | active | rejected | suspended | closed
data.currencystringNoISO-4217 currency code
data.ibanstringYesIBAN (null until active)
data.accountNumberstringYesLocal account number (null until active)
data.bicstringYesBank BIC/SWIFT code
data.bankNamestringYesName of the partner bank holding the account
data.balancenumberNoCurrent available balance
data.cryptoobjectYesLinked crypto settlement details, if any
data.createdAtstring (date-time)NoUTC creation timestamp
data.activatedAtstring (date-time)YesUTC timestamp the account became active

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 '/api/v1/accountissuance/account/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
--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: n4bQgYhMfWWaL+qgxVrQFaO/TxsrC4Is0V1sFbDwCgg='
Response Response Example
200 - Success
{
    "data": {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "customerId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "productId": "1b671a64-40d5-491e-99b0-da01ff1f3341",
        "status": "active",
        "currency": "EUR",
        "iban": "DE89370400440532013000",
        "accountNumber": "0532013000",
        "bic": "COBADEFFXXX",
        "bankName": "ArthaPay Partner Bank AG",
        "balance": 12500.5,
        "crypto": null,
        "createdAt": "2026-08-10T09:15:00Z",
        "activatedAt": "2026-08-10T09:22:41Z"
    }
}
Modified at 2026-09-23 05:54:40
Previous
Create Bank Account
Next
Get Account Issuance Status
Built with