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

Get Product

GET
/api/v1/products/{productId}
Retrieves a single product by id, including its fee schedule, limits, recharge/deposit configuration,
supported currencies, and KYC requirements.
Check kycRequirements before calling Submit Applicant - it lists the requirement codes the product
expects for each customer type - and applicableFor for whether the product is available to individuals,
businesses, or both.
Response Fields (inside data)
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
fees, limits, recharge, and deposit are null when the product has no fee schedule configured.

Request

Path Params

Header Params

Responses

🟢200
application/json
Product retrieved successfully.
Bodyapplication/json

🟠401
🟠404
🔴500
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/v1/products/b1f3c7a2-6c4e-4d91-9f2a-123456789abc' \
--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 - Cards product
{
    "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": "Prepaid",
        "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": "GBP",
            "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": "Cardholder",
            "programId": "PRG-1024"
        },
        "appName": "Cards",
        "fiatCurrencies": "AED,EUR,GBP,USD"
    },
    "requestId": "9f2c4b6e8a1d4f0cb7e35a91d2c46f80",
    "timestamp": "2026-08-22T10:30:00.123Z"
}
Modified at 2026-08-27 08:42:54
Previous
List Products
Next
Get Customer Product Status
Built with