Skip to main content
PATCH
/
v1
/
card-issuer
/
admin
/
{programId}
/
card-limits
curl -X PATCH 'https://crypto-api.yativo.com/api/v1/card-issuer/admin/69ecc05a4fc8c9c148ed1a9a/card-limits' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "max_virtual_per_customer": 3,
    "max_physical_per_customer": 1,
    "max_total_per_customer": 4
  }'

{
  "success": true,
  "message": "Card limits updated",
  "data": {
    "program_id": "69ecc05a4fc8c9c148ed1a9a",
    "card_limits": {
      "max_virtual_per_customer": 3,
      "max_physical_per_customer": 1,
      "max_total_per_customer": 4
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.yativo.com/llms.txt

Use this file to discover all available pages before exploring further.

This is an admin-only endpoint. It sets the maximum number of cards each customer in the program can hold. Issuers cannot set per-customer limits above these ceilings.
​
programId
string
required
The ID of the issuer program to update. Returned by GET /v1/card-issuer/status as data.id.
​
Authorization
string
required
Bearer token: Bearer YOUR_ACCESS_TOKEN
​
max_virtual_per_customer
integer
Maximum virtual cards allowed per customer. Must be 0–5. Default: 1.
​
max_physical_per_customer
integer
Maximum physical cards allowed per customer. Must be 0–5. Default: 1.
​
max_total_per_customer
integer
Maximum total active cards (virtual + physical combined) allowed per customer. Must be 0–5. Default: 2. Gnosis hard cap is 5.
At least one field must be provided. Fields not sent are left unchanged. 
curl -X PATCH 'https://crypto-api.yativo.com/api/v1/card-issuer/admin/69ecc05a4fc8c9c148ed1a9a/card-limits' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "max_virtual_per_customer": 3,
    "max_physical_per_customer": 1,
    "max_total_per_customer": 4
  }'

{
  "success": true,
  "message": "Card limits updated",
  "data": {
    "program_id": "69ecc05a4fc8c9c148ed1a9a",
    "card_limits": {
      "max_virtual_per_customer": 3,
      "max_physical_per_customer": 1,
      "max_total_per_customer": 4
    }
  }
}