---
title: "Update a card"
method: POST
path: "/cards/{cardId}"
tags: ["Cards"]
---

# Update a card

`POST /cards/{cardId}`

Update card and cardholder details

## Path parameters

- `cardId` string, required

## Request body

- CardUpdateCardRequest — Update card
  - `limit` number — Total card authorisation limit.
  - `cancellationDate` string — ISO 8601 date with year, month & day components only. The supplied value must be in the future and at most 1 day before the expiry date.
  - `customFields` CardCardCustomFieldRequest[] — Custom fields
    - `key` string, required — Custom field key
    - `value` string, required — Custom field value
  - `holder` CardUpdateCardHolder
    - `billingAddress` CardAddressDetail — Address details for the cardholder. Optional for individual customers whose partner has verification type EXTERNAL.
      - `addressLine1` string, required — First line of address
      - `addressLine2` string — Second line of address
      - `postTown` string, required — Post town
      - `postCode` string, required — Postcode
      - `country` 'AT' | 'BE' | 'BG' | 'CY' | 'CZ' | 'DK' | 'EE' | 'FI' | 'FR' | 'DE' | 'GR' | 'HR' | 'HU' | 'IS' | 'IE' | 'IT' | 'LV' | 'LI' | 'LT' | 'LU' | 'MT' | 'NL' | 'NO' | 'PL' | 'PT' | 'RO' | 'SK' | 'SI' | 'ES' | 'SE' | 'AX' | 'AW' | 'BL' | 'CW' | 'GF' | 'GL' | 'GP' | 'ME' | 'MF' | 'MQ' | 'NC' | 'PF' | 'PM' | 'RE' | 'SX' | 'TF' | 'WF' | 'YT' | 'AI' | 'BM' | 'FK' | 'GB' | 'GG' | 'GI' | 'GS' | 'IO' | 'JE' | 'KY' | 'MS' | 'PN' | 'SH' | 'TC' | 'VG', required — Country (ISO 3166 alpha-2 country code)
    - `shippingAddress` CardAddressDetail — Address details for the cardholder. Optional for individual customers whose partner has verification type EXTERNAL.
      - `addressLine1` string, required — First line of address
      - `addressLine2` string — Second line of address
      - `postTown` string, required — Post town
      - `postCode` string, required — Postcode
      - `country` 'AT' | 'BE' | 'BG' | 'CY' | 'CZ' | 'DK' | 'EE' | 'FI' | 'FR' | 'DE' | 'GR' | 'HR' | 'HU' | 'IS' | 'IE' | 'IT' | 'LV' | 'LI' | 'LT' | 'LU' | 'MT' | 'NL' | 'NO' | 'PL' | 'PT' | 'RO' | 'SK' | 'SI' | 'ES' | 'SE' | 'AX' | 'AW' | 'BL' | 'CW' | 'GF' | 'GL' | 'GP' | 'ME' | 'MF' | 'MQ' | 'NC' | 'PF' | 'PM' | 'RE' | 'SX' | 'TF' | 'WF' | 'YT' | 'AI' | 'BM' | 'FK' | 'GB' | 'GG' | 'GI' | 'GS' | 'IO' | 'JE' | 'KY' | 'MS' | 'PN' | 'SH' | 'TC' | 'VG', required — Country (ISO 3166 alpha-2 country code)
    - `dateOfBirth` string, date — Cardholder date of birth. Must match date format of yyyy-mm-dd. Required for virtual consumer and physical cards. Must be NULL for individual customers.
    - `mobileNumber` string — Cardholder mobile number. Must start with a '+', followed by the country code and then the mobile number. Required for virtual consumer and physical cards.
    - `email` string, email — Cardholder email
  - `authWindow` CardAuthorisationWindowRequest
    - `startDate` string
    - `endDate` string

## Response `204`

Card updated successfully

## Other responses

- `400` — Invalid request

---

[API](https://skmtc.net/modulrfinance/apis/modulr-api.md) · [All operations](https://skmtc.net/modulrfinance/apis/modulr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modulrfinance/modulr-api/versions/cbd52524c8ef/schema)