Create a cardholder

post

https://api-sandbox.interlace.money/open-api/v2/cards/{accountId}/cardholder

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

accountId

string

required

The UUID of the Account.

Body Params

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

profileId

uuid

required

Required only for MoR mode clients.

cardholderTier

string

required

Defaults to CORPORATE_MANAGED

"CORPORATE_MANAGED"

cardholderRole

string

enum

required

cardholderRole.

Allowed:

cardholderLabel

string

cardholderLabel.

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.

string

required

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

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

nationality

string

required

Nationality. Use a two-letter country code as defined in ISO 3166-1 alpha-2. Example: US

dob

string

required

Date of birth in YYYY-MM-DD format. Example: 1990-01-01

address

object

required

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