Create Cardholder

post

https://api-sandbox.interlace.money/open-api/v3/cardholders

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Corporate-managed card used for internal business expenses, such as advertising, SaaS subscriptions, travel, and logistics.

binId

string

required

The Id of the bin.

accountId

uuid

required

The UUID of the Account.

profileId

uuid

Optional. Required for MoR mode clients.

cardholderTier

string

required

Defaults to CORPORATE_MANAGED

"CORPORATE_MANAGED"

firstName

string

required

User’s first name. Only English alphabet letters (A–Z, a–z) are allowed. Example: John

lastName

string

required

User’s last name. Only English alphabet letters (A–Z, a–z) are allowed. Example: Smith

Note: The combined length of firstName and lastName (with space) must be ≤ 23 characters.

cardholderRole

string

enum

required

Role of the cardholder within the organization, used to distinguish different operational responsibilities.

Allowed:

cardholderLabel

string

Custom label assigned to the cardholder for internal management and identification. Example: Marketing Ad

nameAbbreviation

string

NameAbbreviation is used as an alternative display name when the full name exceeds length constraints or when a shorter format is needed for presentation.

referenceId

string

Unique identifier for referencing the associated request or resource.

string

required

User’s email address. Example: [email protected]

nationality

string

Two-letter country code of nationality, as defined in ISO 3166-1 alpha-2. Example: US. Required for BB BINs.

dob

string

required

Date of birth in YYYY-MM-DD format. Example: 1990-01-01. Required for BB BINs.

phoneNumber

string

required

length ≤ 15

Phone number without the country code, length ≤ 15. Example: 13800138000

phoneCountryCode

string

required

length ≤ 3

The international dialing code of the cardholder's mobile phone, numbers only, no "+", length ≤ 3. Example: 86

address

object

required

User’s address.

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK

400Bad Request