Discard a card

OAuth scope: card.write

Discards the card identified by the id path parameter, permanently blocking its usage.

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

PUT /v2/cards/{id}/discard

Discard a card

cURL

curl --request PUT \
  --url https://thirdparty.qonto.com/v2/cards/{id}/discard \
  --header 'Authorization: Bearer <token>'

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
  }
}

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

Response

200

application/json

Returns the discarded card.

card · object

A representation of a card

Show child attributes