> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gnosispay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Card Daily Spending Limit

> Get and set the daily spending limit for a specific card

> [!NOTE]
>
> **Why this matters for users:** a user with multiple cards may want to limit how much a specific card can spend. For example, capping a card shared with a family member, or a card used only for subscriptions, without changing the overall account limit that governs their other cards. This gives users finer-grained control over their own spending habits.

> [!NOTE]
>
> A card's limit only takes effect if it's set **lower** than the [account's daily spending limit](embedded-integration/accounts/limits), the account limit is always the hard ceiling, regardless of any card-level limit.

## Set Card Daily Spending Limit

Sets the daily spending limit for a card.

`amount` is expressed in the currency's smallest unit, for USD this means cents (e.g. `1000` = `$10.00`, `1000000` = `$10,000.00`). The card must belong to the authenticated user.

The response returns the new limit immediately with `syncStatus: "pending"`, transitioning to `"synced"` once the change has been applied downstream.

> [tab] Sandbox
>
> ```bash theme={null}
> curl --request PUT \
>   --url https://core.sandbox.gnosispay.in/user-api/cards/{cardId}/limit \
>   --header 'Authorization: Bearer <token>' \
>   --header 'Content-Type: application/json' \
>   --data '{
>     "amount": 500000,
>     "currency": "USD"
>   }'
> ```

> [tab] Production
>
> ```bash theme={null}
> curl --request PUT \
>   --url https://core.prod.gnosispay.com/user-api/cards/{cardId}/limit \
>   --header 'Authorization: Bearer <token>' \
>   --header 'Content-Type: application/json' \
>   --data '{
>     "amount": 500000,
>     "currency": "USD"
>   }'
> ```

## Get Card Daily Spending Limit

Returns the daily spending limit configured on a card.

> [tab] Sandbox
>
> ```bash theme={null}
> curl --request GET \
>   --url https://core.sandbox.gnosispay.in/user-api/cards/{cardId}/limit \
>   --header 'Authorization: Bearer <token>'
> ```

> [tab] Production
>
> ```bash theme={null}
> curl --request GET \
>   --url https://core.prod.gnosispay.com/user-api/cards/{cardId}/limit \
>   --header 'Authorization: Bearer <token>'
> ```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.