---
title: "Get card by id"
description: "Retrieve one card with the actual values of every spend control applied to it."
source: https://developers.qashio.com/v2/reference/get-public-v1-erp-cards-by-cardid/
---

# Get card by id

`GET /public/v1/erp/cards/{cardId}`

Requires a Bearer access token.

**Purpose.** Retrieve one card with the actual values of every spend control applied to it.

**Description.** Returns a single card. The payload is the list entry plus the full configuration
behind each control flag: the spend limit amount and period, the allowed or blocked country list, the
merchant categories and groups, the top-up and auto-top-up settings, and the ATM rules. Use it when
you need to display or audit a card's controls rather than just know they exist.

**Input (path).** `cardId` — the card identifier (`CA…`).

**Output.** One card object. All list fields, plus:

| Field | Type | Description |
| --- | --- | --- |
| `purchase_limits` | object | `{ enabled, amount, frequency, limit_currency, number_of_purchases }` |
| `country_limits` | object | `{ restriction_mode, allowed_countries, blocked_countries }` |
| `merchant_category_limits` | object | `{ restriction_type, categories, merchant_groups }` — categories carry their MCC codes |
| `topup_configuration` | object | `{ auto_topup_enabled, auto_topup_amount, frequency }` |
| `auto_top_up_configuration` | object | Auto top-up amount and trigger |
| `atm_configuration` | object | `{ atm_withdrawal_allowed, frequency, max_amount, number_of_withdrawals, limit_per_withdrawal }` |

**Errors.** `401`, `403`, `404`.

### Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `cardId` | string | yes | the card identifier (`CA…`). |

### Example request

```bash
curl -X GET 'https://api.qashio.com/public/v1/erp/cards/%3AcardId' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <access_token>'
```

### Example response (200)

```json
{
  "status_code": 200,
  "success": true,
  "data": {
    "id": "CAj2w5b3w9hoe0ga",
    "card_nickname": "Qashio Card - 1",
    "company_name": "Qashio",
    "status": "Draft",
    "card_type": "Virtual",
    "masked_card_number": "************1234",
    "account_external_id": "AChhak778j2251b0",
    "account_type": "company_account",
    "card_currency": "AED",
    "allowed_max_balance": "10000.00",
    "float_management_enabled": false,
    "topup_type": "manual",
    "card_replaced": false,
    "transaction_limits_active": false,
    "purchase_limits_active": false,
    "country_limits_active": false,
    "category_limits_active": false,
    "atm_withdrawal_allowed": true,
    "low_balance_notification_active": false,
    "low_balance_notification_amount": "500.00",
    "terminated_at": "2026-08-06T07:30:44.941Z",
    "activated_at": "2026-08-06T07:30:44.941Z",
    "issued_at": "2026-08-06T07:30:44.941Z",
    "auto_top_up_configuration": "sample",
    "created_at": "2026-09-09T09:31:49.152Z",
    "cardholder": {
      "name": "John Doe",
      "email": "john.doe@example.com",
      "employee_id": ""
    },
    "segments": [
      {
        "id": "73a772d7-35b8-41a9-8d25-8ac4aab2145e",
        "name": "Qashio",
        "label": "id",
        "code": "UNAUTHORIZED",
        "erp_internal_id": "CAj2w5b3w9hoe0ga",
        "erp_code": "sample"
      }
    ],
    "custom_segments": [
      {
        "id": "73a772d7-35b8-41a9-8d25-8ac4aab2145e",
        "name": "Qashio",
        "label": "id",
        "code": "UNAUTHORIZED",
        "erp_internal_id": "CAj2w5b3w9hoe0ga",
        "erp_code": "sample"
      }
    ],
    "purchase_limits": {
      "frequency": "sample",
      "amount": "1000.00",
      "limit_currency": "AED",
      "enabled": false,
      "number_of_purchases": "sample"
    },
    "country_limits": {
      "restriction_mode": "sample",
      "allowed_countries": [
        {
          "id": null,
          "name": null,
          "label": null,
          "code": null,
          "erp_internal_id": null,
          "erp_code": null
        }
      ],
      "blocked_countries": [
        {
          "id": null,
          "name": null,
          "label": null,
          "code": null,
          "erp_internal_id": null,
          "erp_code": null
        }
      ]
    },
    "merchant_category_limits": {
      "restriction_type": "no_limit",
      "categories": [
        {
          "name": null,
          "mcc_codes": null
        }
      ],
      "merchant_groups": [
        {
          "id": null,
          "name": null,
          "label": null,
          "code": null,
          "erp_internal_id": null,
          "erp_code": null
        }
      ]
    },
    "topup_configuration": {
      "auto_topup_enabled": false,
      "auto_topup_amount": "1000.00",
      "frequency": "sample"
    },
    "atm_configuration": {
      "atm_withdrawal_allowed": true,
      "frequency": "sample",
      "max_amount": "5000.00",
      "number_of_withdrawals": "sample",
      "limit_per_withdrawal": "sample"
    }
  },
  "meta": {
    "request_id": "3adb2d16090c7b3bdbde3b326a814b30",
    "timestamp": "2026-09-09T10:07:52.143Z"
  }
}
```

### Errors

- `401` Unauthorized - missing or invalid Bearer token
- `404` Not Found - the requested resource does not exist