> ## 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.

# Set a card spending limit

> Sets the daily spending limit for a card.

`currency` must match the card account native currency, and `amount` is
in minor units of that currency. Amounts above the maximum configured for
the partner are rejected. A successful request may return
`sync_status: pending`; use `GET /cards/{card_id}/limit` until it becomes
`synced` or `failed`.

Once synced, this is a cumulative spending limit, not a per-transaction
cap. An authorization that causes the cumulative spend for today to meet or
exceed the limit can be approved; subsequent eligible authorizations are
declined.



## OpenAPI

````yaml https://core.sandbox.gnosispay.in/partner-api/openapi.json put /v1/cards/{card_id}/limit
openapi: 3.1.0
info:
  title: Gnosis Pay Partner API
  version: 1.0.0
  description: >-
    Server-to-server API for onboarding users, creating accounts and cards,
    moving

    funds, and managing the card lifecycle. Call this API only from a trusted

    backend. Every request requires a partner access token, and every resource
    is

    scoped to the authenticated partner.
servers:
  - url: https://core.prod.gnosispay.com/partner-api
    description: Production
    variables: {}
  - url: https://core.sandbox.gnosispay.in/core
    description: Sandbox
    variables: {}
security:
  - BearerAuth: []
tags:
  - name: Accounts
  - name: Cards
  - name: Card transactions
  - name: KYC
  - name: Deposits
  - name: Withdrawals
  - name: PCI
  - name: 3DS
  - name: Webhooks
paths:
  /v1/cards/{card_id}/limit:
    put:
      tags:
        - Cards
      summary: Set a card spending limit
      description: >-
        Sets the daily spending limit for a card.


        `currency` must match the card account native currency, and `amount` is

        in minor units of that currency. Amounts above the maximum configured
        for

        the partner are rejected. A successful request may return

        `sync_status: pending`; use `GET /cards/{card_id}/limit` until it
        becomes

        `synced` or `failed`.


        Once synced, this is a cumulative spending limit, not a per-transaction

        cap. An authorization that causes the cumulative spend for today to meet
        or

        exceed the limit can be approved; subsequent eligible authorizations are

        declined.
      operationId: cards.set_limit.v1
      parameters:
        - name: card_id
          in: path
          required: true
          description: The card ID.
          schema:
            $ref: '#/components/schemas/uuid'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SetCardLimitParams'
        description: New daily card spending limit.
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CardLimitResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    uuid:
      type: string
      format: uuid
    SetCardLimitParams:
      type: object
      required:
        - amount
        - currency
      properties:
        amount:
          type: integer
          format: int64
          minimum: 1
          description: |-
            Daily spending limit in minor units of `currency`.
            USD, EUR, and GBP use 2 decimal places, so 1000000 is 10,000.00.
          examples:
            - 1000000
        currency:
          type: string
          description: ISO-4217 currency code. Must match the card account native currency.
          examples:
            - EUR
      examples:
        - amount: 1000000
          currency: EUR
    CardLimitResponse:
      type: object
      required:
        - amount
        - currency
        - decimals
        - sync_status
        - updated_at
        - spent_today
        - remaining
      properties:
        amount:
          type: integer
          format: int64
          description: Configured daily limit in the currency's smallest unit.
        currency:
          type: string
          description: ISO-4217 currency code.
        decimals:
          type: integer
          format: int32
          description: >-
            Number of decimal places for this currency (2 for USD, EUR, and
            GBP).
        sync_status:
          type: string
          enum:
            - pending
            - synced
            - failed
          description: >-
            Application status of the limit. `pending` means the update is still
            being

            applied, `synced` means it is active, and `failed` means it could
            not be

            applied.
        updated_at:
          type: string
          format: date-time
          description: Last time this limit was modified.
        spent_today:
          type: integer
          format: int64
          description: |-
            Eligible card spending counted against this limit since 00:00 UTC,
            expressed in the currency's smallest unit.
        remaining:
          type: integer
          format: int64
          description: >-
            Remaining headroom for today, in the currency's smallest unit. Equal
            to

            `max(0, amount - spent_today)`.
      description: |-
        Full card limit response including today's usage. Returned by
        `GET /cards/{card_id}/limit` and `PUT /cards/{card_id}/limit`.
    Error:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: integer
          format: int32
          description: HTTP status code.
        message:
          type: string
          description: Generic human-readable text for the status code. Do not parse it.
        reason:
          type: string
          description: >-
            Stable machine-readable code identifying the specific cause, present
            only

            for errors that expose one (e.g. `CREATE_CARD_LIMIT_EXCEEDED`).
            Branch on

            this rather than on `message`.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: Bearer

````

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