Artha API
  1. Cards
  • Introduction
  • Authentication
  • KYC/KYB Requirements
  • API Setup Guide
  • Card API Integration Flow
  • Customers
    • Create Customer
      POST
    • List Customers
      GET
    • Get Customer
      GET
    • Update Customer
      PATCH
  • Cards
    • Submit KYC/KYB Applicant
      POST
    • Get Applicant KYC Status
      GET
    • 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 Top-Up Status
      GET
    • Get Card Balance
      GET
    • List Top-Up History
      GET
  • Transactions
    • List All Transactions
    • List Card Transactions
    • List Customer Transactions
    • Get Transaction
  • Products
    • List Products
    • Get Product
  • Utilities
    • Upload Documents
  • Webhook's
    • Webhooks
  1. Cards

Cards List

GET
/baseurl/api/v1/cardslist
Returns a paginated list of all cards.

Request

Query Params

Header Params

Responses

🟢200
application/json
Cards retrieved.
Body

🟠401
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/baseurl/api/v1/cardslist?limit&offset&status&customerId&productId&cardType' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;'
Response Response Example
{
    "data": [
        {
            "cardId": "ef0c9071-f1d5-4782-996c-db9b45c47a29",
            "customerId": "49cf2793-9379-4d1b-9904-5b77aaa5693c",
            "productId": "999a47bf-5c73-4a93-9827-0182f075355d",
            "cardType": "Virtual",
            "currency": "USD",
            "state": "Rejected",
            "createdAt": "2026-03-30T04:43:07.4778144"
        }
    ],
    "pagination": {
        "total": 1,
        "limit": 20,
        "offset": 0,
        "hasMore": false
    }
}
Modified at 2026-03-31 13:31:35
Previous
Issue Card
Next
Get Card
Built with