URL Expired

The URL for this request expired after 30 days.

cardId

uuid

required

subaccountId

uuid

required

The unique identifier of the subaccount related to the card

firstName

string

The first name of the cardholder

lastName

string

The last name of the cardholder

email

string

Cardholder email address

postalCode

string

Cardholder postal code. Format varies by country; no validation or normalization is applied.

corporate

object

The corporate entity that this cardholder is associated with

corporateobject

accept

string

enum

Defaults to application/hal+json

Generated from available response content types

application/hal+jsonapplication/problem+json

Allowed:

application/hal+json``application/problem+json

``200 Successful operation

object

_links

object

required

self

object

required

self object

corporate

object

required

The corporate entity that this cardholder is associated with

alternativeEmployeeId

string | null

An alternative employee identifier, typically configured for specific enterprise integrations.

employeeId

string | null

The unique identifier of the employee

id

string | null

The identifier of the corporate

firstName

string | null

The first name of the cardholder

lastName

string | null

The last name of the cardholder

email

string | null

Cardholder email address

postalCode

string | null

Cardholder postal code as provided by the card network. Format varies by country; no validation or normalization is applied.

createdAt

date-time

required

Date and time when this resource was created, in UTC, following ISO 8601 format.

updatedAt

date-time

required

Date and time when this resource was last updated, in UTC, following ISO 8601 format.

``400 The server cannot or will not process the request due to something that is perceived to be a client error

``401 Authentication credentials were either missing or incorrect

``403 Authentication credentials used do not have have permissions to perform the request

``404 The requested resource was not found on the server

``500 The server encountered an unexpected condition that prevented it from fulfilling the request

curl --request PATCH \
     --url https://api.astrada.co/cards/cardId/cardholder \
     --header 'accept: application/hal+json' \
     --header 'content-type: application/json'

{
  "_links": {
    "self": {
      "href": "/cards/f744b691-bf05-4f2a-ab89-bb1afe4eb840/cardholder"
    }
  },
  "firstName": "John",
  "lastName": "Doe",
  "email": "john.doe@example.com",
  "postalCode": "94105",
  "corporate": {
    "alternativeEmployeeId": "ALT-EMP-12345",
    "employeeId": "bb1afe4eb840",
    "id": "ABC123456789"
  },
  "createdAt": "2024-02-04T18:41:16.142Z",
  "updatedAt": "2024-02-04T18:41:16.142Z"
}