Skip to main content

Contains information about a cardholder.

created_time
string<date-time>
required

Date and time when the resource was created, in UTC.

last_modified_time
string<date-time>
required

Date and time when the resource was last updated, in UTC.

account_holder_group_token
string

Associates the specified account holder group with the cardholder.

Maximum string length: 36
active
boolean
default:false

Specifies if the cardholder is in the ACTIVE state on the Marqeta platform.

address1
string

Cardholder's address.

Maximum string length: 255
address2
string

Additional address information for the cardholder.

Maximum string length: 255
authentication
object

Contains the cardholder's email address and password information.

birth_date
string

Cardholder's date of birth.

birth_place
string

Country where the cardholder was born.

Maximum string length: 255
business_token
string

Unique identifier of the business resource.

city
string

City where the cardholder resides.

Maximum string length: 40
company
string

Company name.

Maximum string length: 255
corporate_card_holder
boolean
default:false

Specifies if the cardholder holds a corporate card.

country
string

Country where the cardholder resides.

Maximum string length: 40
email
string

Valid email address of the cardholder.

Required string length: 1 - 255
first_name
string

Cardholder's first name.

Maximum string length: 40
gender
enum<string>

Gender of the cardholder.

Available options:
F,
M
Maximum string length: 1
honorific
string

Cardholder's title or prefix: Dr., Miss, Mr., Ms., and so on.

Maximum string length: 10
id_card_expiration_date
string
read-only

Expiration date of the cardholder's identification.

id_card_number
string

Cardholder's identification card number.

Maximum string length: 255
identifications
object[]

One or more objects containing identifications associated with the cardholder.

ip_address
string

Cardholder's IP address.

Maximum string length: 39
last_name
string

Cardholder's last name.

Maximum string length: 40
metadata
object

Associates any additional metadata you provide with the cardholder.

middle_name
string

Cardholder's middle name.

Maximum string length: 40
nationality
string

Cardholder's nationality.

Maximum string length: 255
notes
string

Any additional information pertaining to the cardholder.

Maximum string length: 255
parent_token
string

Unique identifier of the parent user or business resource.

Required string length: 1 - 36
passport_expiration_date
string
read-only

Expiration date of the cardholder's passport.

passport_number
string

Cardholder's passport number.

Maximum string length: 40
password
string

Password to the cardholder's user account on the Marqeta platform.

Required string length: 1 - 255
phone
string

Cardholder's telephone number.

Maximum string length: 255
postal_code
string

Postal code of the cardholder's address.

Maximum string length: 10
ssn
string

Cardholder's Social Security Number (SSN).

state
string

State or province where the cardholder resides.

Maximum string length: 2
status
enum<string>

Specifies the status of the cardholder on the Marqeta platform.

Available options:
UNVERIFIED,
LIMITED,
ACTIVE,
SUSPENDED,
CLOSED,
TERMINATED
title
string

Professional title of the cardholder, such as Chief Comptroller.

Maximum string length: 255
token
string

Unique identifier of the cardholder.

Required string length: 1 - 36
uses_parent_account
boolean
default:false

Indicates whether the child shares balances with the parent (true), or the child's balances are independent of the parent (false).

zip
string

United States ZIP code of the cardholder's address.

Maximum string length: 10