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.

ssn
string

Cardholder's Social Security Number (SSN).

zip
string

United States ZIP code of the cardholder's address.

Maximum string length: 10
city
string

City where the cardholder resides.

Maximum string length: 40
email
string

Valid email address of the cardholder.

Required string length: 1 - 255
notes
string

Any additional information pertaining to the cardholder.

Maximum string length: 255
phone
string

Cardholder's telephone number.

Maximum string length: 255
state
string

State or province where the cardholder resides.

Maximum string length: 2
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
active
boolean
default:false

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

gender
enum<string>

Gender of the cardholder.

Available options:
F,
M
Maximum string length: 1
status
enum<string>

Specifies the status of the cardholder on the Marqeta platform.

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

Company name.

Maximum string length: 255
country
string

Country where the cardholder resides.

Maximum string length: 40
address1
string

Cardholder's address.

Maximum string length: 255
address2
string

Additional address information for the cardholder.

Maximum string length: 255
metadata
object

Associates any additional metadata you provide with the cardholder.

password
string

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

Required string length: 1 - 255
honorific
string

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

Maximum string length: 10
last_name
string

Cardholder's last name.

Maximum string length: 40
birth_date
string

Cardholder's date of birth.

first_name
string

Cardholder's first name.

Maximum string length: 40
ip_address
string

Cardholder's IP address.

Maximum string length: 39
birth_place
string

Country where the cardholder was born.

Maximum string length: 255
middle_name
string

Cardholder's middle name.

Maximum string length: 40
nationality
string

Cardholder's nationality.

Maximum string length: 255
postal_code
string

Postal code of the cardholder's address.

Maximum string length: 10
parent_token
string

Unique identifier of the parent user or business resource.

Required string length: 1 - 36
authentication
object

Contains the cardholder's email address and password information.

business_token
string

Unique identifier of the business resource.

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.

passport_number
string

Cardholder's passport number.

Maximum string length: 40
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).

corporate_card_holder
boolean
default:false

Specifies if the cardholder holds a corporate card.

id_card_expiration_date
string
read-only

Expiration date of the cardholder's identification.

passport_expiration_date
string
read-only

Expiration date of the cardholder's passport.

account_holder_group_token
string

Associates the specified account holder group with the cardholder.

Maximum string length: 36