Skip to main content

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.

​
Overview

Spending limits protect against overspending and add an extra layer of control over card usage. You can set a daily limit on your overall card wallet, which applies as a cap across all cards within the account. Card-level limits can also be set at card creation time.
Card-level spending limits (set during card creation) are independent of wallet-level daily limits. Both apply simultaneously — the more restrictive limit takes precedence.
interface SpendingLimits {
  daily_limit: number;
  weekly_limit?: number;
  monthly_limit?: number;
  currency: string;
  current_daily_spend: number;
  reset_at: string;
}

interface SetSpendingLimitRequest {
  daily_limit: number;
}

​
Get Current Spending Limits

Retrieve the current spending limits configured for a card wallet. 
GET /yativo-card/{yativoCardId}/wallet/limits
​
yativoCardId
string
required
Your Yativo Card account ID.
curl -X GET 'https://crypto-api.yativo.com/api/v1/yativo-card/yc_01HX9KZMB3F7VNQP8R2WDGT4E5/wallet/limits' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "status": "success",
  "data": {
    "yativo_card_id": "yc_01HX9KZMB3F7VNQP8R2WDGT4E5",
    "daily_limit": 500.00,
    "daily_spent": 42.50,
    "daily_remaining": 457.50,
    "currency": "USD",
    "limit_reset_at": "2026-03-26T00:00:00Z"
  }
}

​
Set Daily Spending Limit

Update the daily spending limit for a card wallet. The new limit applies immediately. 
PUT /yativo-card/{yativoCardId}/wallet/limits
​
yativoCardId
string
required
Your Yativo Card account ID.
​
daily_limit
number
required
The maximum amount that can be spent across all cards in a single calendar day (in USD). Set to 0 or null to remove the daily limit.
curl -X PUT 'https://crypto-api.yativo.com/api/v1/yativo-card/yc_01HX9KZMB3F7VNQP8R2WDGT4E5/wallet/limits' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "daily_limit": 1000.00
  }'

{
  "status": "success",
  "data": {
    "yativo_card_id": "yc_01HX9KZMB3F7VNQP8R2WDGT4E5",
    "daily_limit": 1000.00,
    "currency": "USD",
    "updated_at": "2026-03-25T17:00:00Z"
  }
}

​
Remove Daily Limit

To remove the daily spending limit entirely, set daily_limit to null: 
curl -X PUT 'https://crypto-api.yativo.com/api/v1/yativo-card/yc_01HX9KZMB3F7VNQP8R2WDGT4E5/wallet/limits' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "daily_limit": null
  }'

{
  "status": "success",
  "data": {
    "yativo_card_id": "yc_01HX9KZMB3F7VNQP8R2WDGT4E5",
    "daily_limit": null,
    "currency": "USD",
    "updated_at": "2026-03-25T17:05:00Z"
  }
}
Removing spending limits increases risk exposure. Only remove limits if you have other controls in place, such as low card balances or card-level limits.

​
B2B Issuer: Customer Spending Limits

If you are a Card Issuer, you can view and set spending limits for your customers’ card accounts using the B2B endpoints.

​
Get Customer Limits

GET /yativo-card/customers/{yativoCardId}/wallet/limits
​
yativoCardId
string
required
The customer’s Yativo Card account ID.
curl -X GET 'https://crypto-api.yativo.com/api/v1/yativo-card/customers/yc_customer_01HX9KZMB3F7/wallet/limits' \
  -H 'Authorization: Bearer YOUR_ISSUER_API_KEY'

{
  "status": "success",
  "data": {
    "customer_id": "yc_customer_01HX9KZMB3F7",
    "daily_limit": 250.00,
    "daily_spent": 0.00,
    "daily_remaining": 250.00,
    "currency": "USD",
    "limit_reset_at": "2026-03-26T00:00:00Z"
  }
}

​
Set Customer Limits

PUT /yativo-card/customers/{yativoCardId}/wallet/limits
​
yativoCardId
string
required
The customer’s Yativo Card account ID.
​
daily_limit
number
required
The new daily limit for the customer’s account.
curl -X PUT 'https://crypto-api.yativo.com/api/v1/yativo-card/customers/yc_customer_01HX9KZMB3F7/wallet/limits' \
  -H 'Authorization: Bearer YOUR_ISSUER_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "daily_limit": 500.00
  }'

{
  "status": "success",
  "data": {
    "customer_id": "yc_customer_01HX9KZMB3F7",
    "daily_limit": 500.00,
    "currency": "USD",
    "updated_at": "2026-03-25T17:10:00Z"
  }
}

​
Limit Types Summary

Limit TypeEndpointScope
Daily wallet limitPUT /yativo-card/{id}/wallet/limitsAll cards in the account
Card spending limitSet via create-cardPer card, per frequency period
Customer daily limit (B2B)PUT /yativo-card/customers/{id}/wallet/limitsAll cards under a customer
For B2B issuers managing corporate or consumer card programs, setting conservative daily limits at the customer level is recommended as a risk management best practice. Customers can request limit increases through your platform, and you can raise them via API.