curl -X PATCH 'https://crypto-api.yativo.com/api/v1/yativo-card/admin/yativo_card_customer_8f9a_abc_1769031332068/card-limits' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"max_virtual": 3,
"max_physical": 2,
"max_total": 5
}'
{
"success": true,
"message": "Account card limits updated",
"data": {
"yativo_card_id": "yativo_card_customer_8f9a...abc_1769031332068",
"card_limits": {
"max_virtual": 3,
"max_physical": 2,
"max_total": 5,
"set_by": "admin_user_id",
"set_at": "2026-05-05T12:00:00.000Z"
}
}
}
{
"success": false,
"error_code": "INVALID_LIMIT",
"message": "max_virtual must be 0–5"
}
{
"success": false,
"error_code": "NO_CHANGES",
"message": "Provide at least one limit field to update"
}
{
"success": false,
"error_code": "NOT_FOUND",
"message": "Card not found"
}
Card Customer — Card Operations
Set Account Card Limits (Admin)
Admin: set per-account card limits for any user or customer card
PATCH
/
v1
/
yativo-card
/
admin
/
{yativoCardId}
/
card-limits
curl -X PATCH 'https://crypto-api.yativo.com/api/v1/yativo-card/admin/yativo_card_customer_8f9a_abc_1769031332068/card-limits' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"max_virtual": 3,
"max_physical": 2,
"max_total": 5
}'
{
"success": true,
"message": "Account card limits updated",
"data": {
"yativo_card_id": "yativo_card_customer_8f9a...abc_1769031332068",
"card_limits": {
"max_virtual": 3,
"max_physical": 2,
"max_total": 5,
"set_by": "admin_user_id",
"set_at": "2026-05-05T12:00:00.000Z"
}
}
}
{
"success": false,
"error_code": "INVALID_LIMIT",
"message": "max_virtual must be 0–5"
}
{
"success": false,
"error_code": "NO_CHANGES",
"message": "Provide at least one limit field to update"
}
{
"success": false,
"error_code": "NOT_FOUND",
"message": "Card not found"
}
This is an admin-only endpoint. It sets card limits directly on a specific account, bypassing the program ceiling. Platform hard cap is 5 active cards.
string
required
The
yativo_card_id of the account (user or customer card) to update.string
required
Bearer token:
Bearer YOUR_ACCESS_TOKENinteger
Maximum virtual cards for this account. Must be 0–5.
integer
Maximum physical cards for this account. Must be 0–5.
integer
Maximum total active cards (virtual + physical combined) for this account. Must be 0–5.
curl -X PATCH 'https://crypto-api.yativo.com/api/v1/yativo-card/admin/yativo_card_customer_8f9a_abc_1769031332068/card-limits' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"max_virtual": 3,
"max_physical": 2,
"max_total": 5
}'
{
"success": true,
"message": "Account card limits updated",
"data": {
"yativo_card_id": "yativo_card_customer_8f9a...abc_1769031332068",
"card_limits": {
"max_virtual": 3,
"max_physical": 2,
"max_total": 5,
"set_by": "admin_user_id",
"set_at": "2026-05-05T12:00:00.000Z"
}
}
}
{
"success": false,
"error_code": "INVALID_LIMIT",
"message": "max_virtual must be 0–5"
}
{
"success": false,
"error_code": "NO_CHANGES",
"message": "Provide at least one limit field to update"
}
{
"success": false,
"error_code": "NOT_FOUND",
"message": "Card not found"
}