CHcheckout
Cardholders

Get cardholder details

Retrieve the details for a cardholder you created previously.

get/issuing/cardholders/{cardholderId}

Request

Path parameters

cardholderIdstring required

The cardholder's unique identifier.

Example:crh_d3ozhf43pcq2xbldn2g45qnb44

Response

Cardholder retrieved successfully

idstring required

The cardholder's unique identifier.

typestring required

The cardholder type. Currently individual is the only supported value.

first_namestring required

The cardholder's first name.

middle_namestring

The cardholder's middle name.

last_namestring required

The cardholder's last name.

emailstring email

The cardholder's email address.

Emails are validated against the <a href="https://datatracker.ietf.org/doc/html/rfc6530">rfc6530</a> standard.

date_of_birthstring date

The cardholder's date of birth. <br/>Format – YYYY-MM-DD

referencestring

Your reference.

client_idstring required

The client's unique identifier.

account_entity_idstring

The entity's unique identifier.

parent_sub_entity_idstring

The entity's unique identifier.

entity_idstring required

The entity's unique identifier.

status'active' | 'pending' | 'restricted' | 'requirements_due' | 'inactive' | 'rejected' | 'draft' | 'suspended'

The cardholder's status.

created_datestring date-time
last_modified_datestring date-time

Example response

{
  "id": "crh_d3ozhf43pcq2xbldn2g45qnb44",
  "type": "individual",
  "first_name": "John",
  "middle_name": "Fitzgerald",
  "last_name": "Kennedy",
  "email": "john.kennedy@myemaildomain.com",
  "phone_number": {
    "country_code": "+1",
    "number": "415 555 2671"
  },
  "date_of_birth": "1985-05-28T00:00:00.0000000",
  "billing_address": {
    "address_line1": "Checkout.com",
    "address_line2": "90 Tottenham Court Road",
    "city": "London",
    "state": "London",
    "zip": "W1T 4TJ",
    "country": "GB"
  },
  "residency_address": {
    "address_line1": "Checkout.com",
    "address_line2": "90 Tottenham Court Road",
    "city": "London",
    "state": "London",
    "zip": "W1T 4TJ",
    "country": "GB"
  },
  "reference": "X-123456-N11",
  "client_id": "cli_vkuhvk4vjn2edkps7dfsq6emqm",
  "account_entity_id": "ent_fa6psq242dcd6fdn5gifcq1491",
  "parent_sub_entity_id": "ent_fa6psq242dcd6fdn5gifcq1491",
  "entity_id": "ent_fa6psq242dcd6fdn5gifcq1491",
  "status": "active",
  "created_date": "2019-09-10T10:11:12.0000000+00:00",
  "last_modified_date": "2019-09-11T10:11:12.0000000+00:00",
  "_links": {
    "self": {
      "href": "https://{prefix}.api.checkout.com/issuing/cardholders/crh_d3ozhf43pcq2xbldn2g45qnb44",
      "actions": [
        "GET"
      ],
      "types": [
        "application/json"
      ]
    },
    "cards": {
      "href": "https://{prefix}.api.checkout.com/issuing/cards",
      "actions": [
        "POST"
      ],
      "types": [
        "application/json"
      ]
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.