Update a card's limits

OAuth scope: card.write

This operation requires Strong Customer Authentication.

---

Updates the limits of the card identified by the id path parameter.

Only admins and owners of an organization have the permissions to update a card’s limit.

This endpoint is still in beta. Please get in touch with our team if you have any question or feedback: here.

PATCH /v2/cards/{id}/limits

Update a card's limits

cURL

curl --request PATCH \
  --url https://thirdparty.qonto.com/v2/cards/{id}/limits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "card": {
    "atm_monthly_limit": 1000,
    "atm_daily_limit_option": true,
    "atm_daily_limit": 1000,
    "payment_monthly_limit": 1000,
    "payment_daily_limit_option": true,
    "payment_daily_limit": 1000,
    "payment_transaction_limit_option": true,
    "payment_transaction_limit": 1000
  }
}
'

200

Example

{
  "card": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "nickname": "💳 for 🍗",
    "embossed_name": "DOLORES KOULECHOV",
    "status": "pending",
    "pin_set": true,
    "mask_pan": "511768******7662",
    "exp_month": "3",
    "exp_year": "2024",
    "last_activity_at": "2023-11-07T05:31:56Z",
    "last_digits": "7662",
    "ship_to_business": false,
    "atm_option": true,
    "nfc_option": true,
    "online_option": true,
    "foreign_option": true,
    "atm_monthly_limit": 1000,
    "atm_monthly_spent": 1000,
    "atm_daily_limit": 1000,
    "atm_daily_spent": 0,
    "atm_daily_limit_option": true,
    "payment_monthly_limit": 1000,
    "payment_monthly_spent": 1000,
    "payment_daily_limit": 1000,
    "payment_daily_spent": 1000,
    "payment_daily_limit_option": true,
    "payment_transaction_limit": 1000,
    "payment_transaction_limit_option": true,
    "active_days": [
      1,
      3,
      5
    ],
    "holder_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "initiator_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "bank_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "updated_at": "2023-11-07T05:31:56Z",
    "created_at": "2023-11-07T05:31:56Z",
    "shipped_at": null,
    "card_type": "debit",
    "card_level": "standard",
    "payment_lifespan_limit": 100,
    "payment_lifespan_spent": 42,
    "pre_expires_at": "2023-11-07T05:31:56Z",
    "categories": [
      "transport",
      "restaurant_and_bar",
      "food_and_grocery"
    ],
    "renewed": false,
    "renewal": false,
    "parent_card_summary": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "last_digits": "7662"
    },
    "had_operation": false,
    "had_pin_operation": false,
    "card_design": "standard.recycled.plastic.2023",
    "type_of_print": "embossed",
    "upsold": false,
    "upsell": false,
    "discard_on": "2022-11-31",
    "reordered": false,
    "appearance": {
      "assets": {
        "front_large": "https://qonto.com/card-designs/standard/standard.recycled.plastic.2023/front_large.png",
        "front_small": "https://qonto.com/card-designs/standard/standard.recycled.plastic.2023/front_small.png",
        "front_small_wallet": "https://qonto.com/card-designs/standard/standard.recycled.plastic.2023/front_small_wallet.png"
      },
      "theme": "dark",
      "gradient_hex_color": "#000000"
    },
    "has_only_user_liftable_locks": true
  }
}

This endpoint is a sensitive action and requires Strong Customer Authentication (SCA). You may receive a 428 Precondition Required response, which means SCA is required before proceeding.

Authorizations

Authorization · string · header · required

Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.

Headers

X-Qonto-Staging-Token · string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

Path Parameters

id · string<uuid> · required

Unique card identifier

Body

application/json

UpdatePhysicalCardLimits

UpdateVirtualCardLimits

UpdateFlashCardLimits

UpdateAdvertisingCardLimits

card · object · required

Show child attributes

Response

200

application/json

Returns the updated card.

card · object

A representation of a card

Show child attributes