1. Products
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.
      POST
    • List a customer's payees.
      GET
    • Update a payee.
      PUT
    • Retrieve a payee by id.
      GET
    • Look up an existing payee.
      GET
    • List the currencies a payee can be created in.
      GET
    • List the accepted payment purpose codes for a payee.
      GET
    • List the countries a payee can be created in.
      GET
    • List currency/country pairings for payees.
      GET
    • List the accepted beneficiary relationship codes.
      GET
  • 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
      • Get Account Details
      • Get Account Issuance Status
    • 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. Products

List Products

GET
/api/v1/products
Returns a paginated list of products available for onboarding, newest first. Each item is the full product
object - the same shape Get Product returns, including fees, limits, and KYC requirements.
Product types (type filter)
typeReturns
CardsPhysical and virtual card products
BanksIBAN / bank account products
WalletsCustodial crypto wallet products
ExchangeFiat-crypto exchange and conversion products
PaymentsPayout and payment products
Omit type to get every product. To filter by customer type instead, read the applicableFor field
on each product (individual, business, or individual,business).
Response Fields
FieldTypeDescription
data[]arrayProduct objects - fields below
pagination.totalintegerTotal products matching the filter
pagination.limit / offsetintegerPage window applied (limit is capped at 100)
pagination.hasMorebooleanWhether further pages are available
Product object
FieldTypeDescription
productIdstring (uuid)Product identifier - use it on the applicant, onboarding, and status calls
namestringDisplay name
codestringInternal product code
organizationstring, nullableScheme / association (e.g. Visa, SEPA)
typestring, nullableForm factor / instrument type (e.g. Physical, Virtual)
countrystring, nullableIssuing country
binstring, nullableCard BIN - card products only
currencystring, nullablePrimary currency
statusstringProduct status - Active
allowMultipleCardsbooleanWhether a customer may hold more than one
needProductCardHolderbooleanIndicates whether a cardholder is required. If true, the Cardholder Create API must be called.
kycRequiredbooleanWhether KYC is required before issuing
applicableForstring, nullableCustomer types this product can be issued to - individual, business, or individual,business
categorystring, nullableConsumption/usage category
descriptionstring, nullableProduct description
fundingSourcestring, nullableHow the product is funded
managedTypestring, nullableManagement model
reviewTimestring, nullableExpected review turnaround
envelopeRequiredbooleanWhether an envelope number is required
feesobject, nullableissuingFee, maintenanceFee, freightFee, rechargeMinFee, rechargeMaxFee, atmWithdrawalFee, atmBalanceInquiryFee, cardCancellationFee, transactionFee, nonEeaConsumptionFee, firstRechargeAmount
limitsobject, nullableminLimit, maxLimit, accountBalanceLimit, dailyRechargeLimit, monthlyRechargeLimit, dailyPaymentLimit, atmDailyWithdrawalLimit, spendingLimit
rechargeobject, nullablecurrency, minAmount, maxAmount, minFee, maxFee
depositobject, nullablerequiredForActivation, minAmount, maxAmount, balanceRetention
operationsarray/object, nullableOperation flags for the product ({ Name, IsEnabled } entries)
supportedPlatformsarray of string, nullablePlatforms the product is offered on
kycRequirementsarray, nullable[{ accountType, requirements[] }] - requirement codes per customer type
metadataobject, nullableAdditional product metadata
appNamestringProduct type - Cards, Banks, Wallets, Exchange, Payments
fiatCurrenciesstring, nullableComma-separated fiat currencies the product supports
List responses carry data and pagination only - no requestId / timestamp.

Request

Query Params

Header Params

Responses

🟢200
application/json
A paginated list of products.
Bodyapplication/json

🟠401
🔴500
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/v1/products?type=Cards&limit=20&offset=0' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;' \
--header 'X-Idempotency-Key;'
Response Response Example
200 - All products (no type filter) - Cards, Banks, Wallets, Exchange, Payments
{
    "data": [
        {
            "productId": "b1f3c7a2-6c4e-4d91-9f2a-123456789abc",
            "name": "Visa Platinum Prepaid",
            "code": "VISA_PLAT_PP",
            "organization": "Visa",
            "type": "Physical",
            "country": "GB",
            "bin": "489537",
            "currency": "GBP",
            "status": "Active",
            "allowMultipleCards": true,
            "needProductCardHolder": false,
            "kycRequired": true,
            "applicableFor": "individual,business",
            "category": "Consumption",
            "description": "Physical Visa prepaid card with ATM access and worldwide acceptance.",
            "fundingSource": "Fiat",
            "managedType": "Managed",
            "reviewTime": "1-2 business days",
            "envelopeRequired": true,
            "fees": {
                "issuingFee": 15,
                "maintenanceFee": 2.5,
                "freightFee": 8,
                "rechargeMinFee": 1,
                "rechargeMaxFee": 25,
                "atmWithdrawalFee": 2.5,
                "atmBalanceInquiryFee": 0.5,
                "cardCancellationFee": 10,
                "transactionFee": 0.35,
                "nonEeaConsumptionFee": 1.75,
                "firstRechargeAmount": 50
            },
            "limits": {
                "minLimit": 10,
                "maxLimit": 10000,
                "accountBalanceLimit": 25000,
                "dailyRechargeLimit": 5000,
                "monthlyRechargeLimit": 30000,
                "dailyPaymentLimit": 3000,
                "atmDailyWithdrawalLimit": 500,
                "spendingLimit": 10000
            },
            "recharge": {
                "currency": "USD",
                "minAmount": 10,
                "maxAmount": 5000,
                "minFee": 1,
                "maxFee": 25
            },
            "deposit": {
                "requiredForActivation": true,
                "minAmount": 50,
                "maxAmount": 25000,
                "balanceRetention": 0
            },
            "operations": [
                {
                    "Name": "NeedPhotoForActiveCard",
                    "IsEnabled": true
                },
                {
                    "Name": "AllowPinChange",
                    "IsEnabled": true
                }
            ],
            "supportedPlatforms": [
                "Web",
                "iOS",
                "Android"
            ],
            "kycRequirements": [
                {
                    "accountType": "individual",
                    "requirements": [
                        "FullName",
                        "Comms",
                        "FullAddress",
                        "IdDocument",
                        "Selfie"
                    ]
                },
                {
                    "accountType": "business",
                    "requirements": [
                        "CompanyDetails",
                        "CompanyAddress",
                        "Directors",
                        "UBOs",
                        "IncorporationCertificate"
                    ]
                }
            ],
            "metadata": {
                "provider": "Artha",
                "programId": "PRG-1024"
            },
            "appName": "Cards",
            "fiatCurrencies": "USD"
        },
        {
            "productId": "5e91a0d4-2b77-4c1a-8d36-9ab0c1d2e3f4",
            "name": "Multi-Currency IBAN Account",
            "code": "IBAN_MC_EU",
            "organization": "SEPA",
            "type": "Virtual",
            "country": "LT",
            "bin": null,
            "currency": "EUR",
            "status": "Active",
            "allowMultipleCards": false,
            "needProductCardHolder": false,
            "kycRequired": true,
            "applicableFor": "individual,business",
            "category": "Banking",
            "description": "Dedicated multi-currency IBAN with SEPA and SWIFT rails.",
            "fundingSource": "BankTransfer",
            "managedType": "Managed",
            "reviewTime": "2-5 business days",
            "envelopeRequired": false,
            "fees": {
                "issuingFee": 0,
                "maintenanceFee": 5,
                "freightFee": 0,
                "rechargeMinFee": 0,
                "rechargeMaxFee": 0,
                "atmWithdrawalFee": 0,
                "atmBalanceInquiryFee": 0,
                "cardCancellationFee": 0,
                "transactionFee": 0.25,
                "nonEeaConsumptionFee": 0,
                "firstRechargeAmount": 0
            },
            "limits": {
                "minLimit": 1,
                "maxLimit": 250000,
                "accountBalanceLimit": 1000000,
                "dailyRechargeLimit": 100000,
                "monthlyRechargeLimit": 500000,
                "dailyPaymentLimit": 100000,
                "atmDailyWithdrawalLimit": 0,
                "spendingLimit": 250000
            },
            "recharge": {
                "currency": "EUR",
                "minAmount": 1,
                "maxAmount": 100000,
                "minFee": 0,
                "maxFee": 0
            },
            "deposit": {
                "requiredForActivation": false,
                "minAmount": 0,
                "maxAmount": 1000000,
                "balanceRetention": 0
            },
            "operations": [
                {
                    "Name": "HostedKycRequired",
                    "IsEnabled": true
                },
                {
                    "Name": "AllowSwift",
                    "IsEnabled": true
                }
            ],
            "supportedPlatforms": [
                "Web"
            ],
            "kycRequirements": [
                {
                    "accountType": "individual",
                    "requirements": [
                        "FullName",
                        "Comms",
                        "FullAddress",
                        "IdDocument",
                        "ProofOfAddress",
                        "SourceOfFunds"
                    ]
                },
                {
                    "accountType": "business",
                    "requirements": [
                        "CompanyDetails",
                        "CompanyAddress",
                        "Directors",
                        "UBOs",
                        "IncorporationCertificate",
                        "ShareholderRegistry"
                    ]
                }
            ],
            "metadata": {
                "provider": "Artha",
                "hostedKyc": true
            },
            "appName": "Banks",
            "fiatCurrencies": "CHF,EUR,GBP,PLN,USD"
        },
        {
            "productId": "c47b2f10-9d38-4e52-b6a1-4f5c6d7e8a90",
            "name": "Crypto Custody Wallet",
            "code": "WLT_CUSTODY",
            "organization": "Fireblocks",
            "type": "Virtual",
            "country": "AE",
            "bin": null,
            "currency": "USDT",
            "status": "Active",
            "allowMultipleCards": false,
            "needProductCardHolder": false,
            "kycRequired": true,
            "applicableFor": "individual,business",
            "category": "Custody",
            "description": "Custodial multi-asset crypto wallet with per-asset deposit addresses.",
            "fundingSource": "Crypto",
            "managedType": "Custodial",
            "reviewTime": "Instant",
            "envelopeRequired": false,
            "fees": {
                "issuingFee": 0,
                "maintenanceFee": 0,
                "freightFee": 0,
                "rechargeMinFee": 0.5,
                "rechargeMaxFee": 10,
                "atmWithdrawalFee": 0,
                "atmBalanceInquiryFee": 0,
                "cardCancellationFee": 0,
                "transactionFee": 0.1,
                "nonEeaConsumptionFee": 0,
                "firstRechargeAmount": 0
            },
            "limits": {
                "minLimit": 10,
                "maxLimit": 500000,
                "accountBalanceLimit": 2000000,
                "dailyRechargeLimit": 100000,
                "monthlyRechargeLimit": 1000000,
                "dailyPaymentLimit": 100000,
                "atmDailyWithdrawalLimit": 0,
                "spendingLimit": 500000
            },
            "recharge": {
                "currency": "USDT",
                "minAmount": 10,
                "maxAmount": 100000,
                "minFee": 0.5,
                "maxFee": 10
            },
            "deposit": {
                "requiredForActivation": false,
                "minAmount": 0,
                "maxAmount": 2000000,
                "balanceRetention": 0
            },
            "operations": [
                {
                    "Name": "AllowWhitelistedWithdrawal",
                    "IsEnabled": true
                },
                {
                    "Name": "TravelRuleRequired",
                    "IsEnabled": true
                }
            ],
            "supportedPlatforms": [
                "Web",
                "iOS",
                "Android"
            ],
            "kycRequirements": [
                {
                    "accountType": "individual",
                    "requirements": [
                        "FullName",
                        "Comms",
                        "FullAddress",
                        "IdDocument",
                        "Selfie"
                    ]
                },
                {
                    "accountType": "business",
                    "requirements": [
                        "CompanyDetails",
                        "Directors",
                        "UBOs"
                    ]
                }
            ],
            "metadata": {
                "provider": "Artha",
                "assets": "BTC,ETH,USDT"
            },
            "appName": "Wallets",
            "fiatCurrencies": "AED,USD"
        },
        {
            "productId": "8ad4e5f6-71b2-4c83-9d40-51e6f7a8b9c0",
            "name": "Fiat-Crypto Exchange Account",
            "code": "EXG_FIAT_CRYPTO",
            "organization": "Arthapay",
            "type": "Virtual",
            "country": "AE",
            "bin": null,
            "currency": "USD",
            "status": "Active",
            "allowMultipleCards": false,
            "needProductCardHolder": false,
            "kycRequired": true,
            "applicableFor": "individual,business",
            "category": "Trading",
            "description": "Buy, sell, and convert between fiat and crypto pairs from a single balance.",
            "fundingSource": "Wallet",
            "managedType": "Managed",
            "reviewTime": "Instant",
            "envelopeRequired": false,
            "fees": {
                "issuingFee": 0,
                "maintenanceFee": 0,
                "freightFee": 0,
                "rechargeMinFee": 0,
                "rechargeMaxFee": 0,
                "atmWithdrawalFee": 0,
                "atmBalanceInquiryFee": 0,
                "cardCancellationFee": 0,
                "transactionFee": 0.2,
                "nonEeaConsumptionFee": 0,
                "firstRechargeAmount": 0
            },
            "limits": {
                "minLimit": 5,
                "maxLimit": 100000,
                "accountBalanceLimit": 500000,
                "dailyRechargeLimit": 50000,
                "monthlyRechargeLimit": 250000,
                "dailyPaymentLimit": 50000,
                "atmDailyWithdrawalLimit": 0,
                "spendingLimit": 100000
            },
            "recharge": {
                "currency": "USD",
                "minAmount": 5,
                "maxAmount": 50000,
                "minFee": 0,
                "maxFee": 0
            },
            "deposit": {
                "requiredForActivation": false,
                "minAmount": 0,
                "maxAmount": 500000,
                "balanceRetention": 0
            },
            "operations": [
                {
                    "Name": "AllowInstantConversion",
                    "IsEnabled": true
                },
                {
                    "Name": "QuoteExpirySeconds",
                    "IsEnabled": true
                }
            ],
            "supportedPlatforms": [
                "Web",
                "iOS",
                "Android"
            ],
            "kycRequirements": [
                {
                    "accountType": "individual",
                    "requirements": [
                        "FullName",
                        "Comms",
                        "FullAddress",
                        "IdDocument",
                        "SourceOfFunds"
                    ]
                },
                {
                    "accountType": "business",
                    "requirements": [
                        "CompanyDetails",
                        "Directors",
                        "UBOs",
                        "SourceOfFunds"
                    ]
                }
            ],
            "metadata": {
                "provider": "Artha",
                "pairs": "USDT/AED,USDT/USD,BTC/USD"
            },
            "appName": "Exchange",
            "fiatCurrencies": "AED,EUR,GBP,USD"
        },
        {
            "productId": "2d6f9b48-3c15-4a77-8e29-0b1c2d3e4f50",
            "name": "Global Payouts",
            "code": "PAY_GLOBAL",
            "organization": "Arthapay",
            "type": "Virtual",
            "country": "US",
            "bin": null,
            "currency": "USD",
            "status": "Active",
            "allowMultipleCards": false,
            "needProductCardHolder": false,
            "kycRequired": true,
            "applicableFor": "business",
            "category": "Payouts",
            "description": "Send local and cross-border payouts to bank accounts in 60+ countries.",
            "fundingSource": "Wallet",
            "managedType": "Managed",
            "reviewTime": "3-5 business days",
            "envelopeRequired": false,
            "fees": {
                "issuingFee": 0,
                "maintenanceFee": 10,
                "freightFee": 0,
                "rechargeMinFee": 0,
                "rechargeMaxFee": 0,
                "atmWithdrawalFee": 0,
                "atmBalanceInquiryFee": 0,
                "cardCancellationFee": 0,
                "transactionFee": 1.5,
                "nonEeaConsumptionFee": 0,
                "firstRechargeAmount": 0
            },
            "limits": {
                "minLimit": 1,
                "maxLimit": 500000,
                "accountBalanceLimit": 2000000,
                "dailyRechargeLimit": 250000,
                "monthlyRechargeLimit": 1000000,
                "dailyPaymentLimit": 250000,
                "atmDailyWithdrawalLimit": 0,
                "spendingLimit": 500000
            },
            "recharge": {
                "currency": "USD",
                "minAmount": 1,
                "maxAmount": 250000,
                "minFee": 0,
                "maxFee": 0
            },
            "deposit": {
                "requiredForActivation": false,
                "minAmount": 0,
                "maxAmount": 2000000,
                "balanceRetention": 0
            },
            "operations": [
                {
                    "Name": "HostedKycRequired",
                    "IsEnabled": true
                },
                {
                    "Name": "AllowBulkPayout",
                    "IsEnabled": true
                }
            ],
            "supportedPlatforms": [
                "Web"
            ],
            "kycRequirements": [
                {
                    "accountType": "business",
                    "requirements": [
                        "CompanyDetails",
                        "CompanyAddress",
                        "Directors",
                        "UBOs",
                        "IncorporationCertificate",
                        "TaxDocument"
                    ]
                }
            ],
            "metadata": {
                "provider": "Artha",
                "corridors": "US,EU,UK,AE,IN"
            },
            "appName": "Payments",
            "fiatCurrencies": "AED,EUR,GBP,INR,USD"
        }
    ],
    "pagination": {
        "total": 5,
        "limit": 20,
        "offset": 0,
        "hasMore": false
    }
}
Modified at 2026-08-27 08:42:43
Previous
API Setup Guide
Next
Get Product
Built with