Artha API
  1. Card Operations
  • Introduction
  • Authentication
  • KYC/KYB Requirements
  • API Setup Guide
  • Customers
    • Create Customer
      POST
    • List Customers
      GET
    • Get Customer
      GET
    • Update Customer
      PATCH
  • Cards
    • Submit KYC/KYB Applicant
      POST
    • Issue Card
      POST
    • Cards List
      GET
    • Get Card
      GET
    • Get Sensitive Card Details
      GET
  • Card Operations
    • Activate Card
      POST
    • Freeze Card
      POST
    • Unfreeze Card
      POST
    • Cancel Card
      POST
    • Replace Card
      POST
    • Set / Reset Card PIN
      POST
    • Get Card Limits
      GET
    • Update Card Limits
      POST
  • Funding
    • Top Up Card
      POST
    • Get Card Balance
      GET
    • List Top-Up History
      GET
  • Transactions
    • List All Transactions
      GET
    • List Card Transactions
      GET
    • List Customer Transactions
      GET
    • Get Transaction
      GET
  • Products
    • List Products
    • Get Product
  • Utilities
    • Upload Documents
  • Webhook's
    • Webhooks
  1. Card Operations

Get Card Limits

GET
{{baseUrl}}/api/v1/cards/{cardId}/limits
Returns the current spending limits configured for a card. Limits are defined in the card's currency.
Limit Types:
daily_limit — maximum spend per calendar day
monthly_limit — maximum spend per calendar month
per_transaction_limit — maximum amount per single transaction
atm_withdrawal_limit — maximum ATM cash withdrawal per day
yearly_limit — annual spend cap
lifetime_limit — total lifetime spend cap

📤 Response Fields#

FieldTypeDescriptionNotes
card_idstring (uuid)--
daily_limitnumber- Example: 500.0nullable
monthly_limitnumber- Example: 5000.0nullable
per_transaction_limitnumber- Example: 250.0nullable
atm_withdrawal_limitnumber- Example: 200.0nullable
yearly_limitnumber-nullable
lifetime_limitnumber-nullable
currencystring- Example: GBPnullable

Request

Path Params

Header Params

Responses

🟢200
application/json
Card limits retrieved.
Body

🟠401
🟠404
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET '{{baseUrl}}/api/v1/cards/a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11/limits' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;'
Response Response Example
200 - Success
{
    "data": {
        "card_id": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11",
        "daily_limit": 500,
        "monthly_limit": 5000,
        "per_transaction_limit": 250,
        "atm_withdrawal_limit": 200,
        "yearly_limit": 50000,
        "lifetime_limit": null,
        "currency": "GBP"
    }
}
Modified at 2026-02-18 13:24:29
Previous
Set / Reset Card PIN
Next
Update Card Limits
Built with