POST///
Create a business director resource.
URL path parameters
| Fields | Description |
|---|---|
| business_token string Required | Unique identifier of the business resource. Allowable Values: Existing business token |
Request body
| Fields | Description |
|---|---|
| active boolean Optional | Indicates whether the business director is active. Allowable Values: true, false |
| address object Optional | Address associated with the business. Allowable Values: address1, address2, city, country, postal_code, state, zip |
| address.address1 string Optional | Street name and number of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| address.address2 string Optional | Additional address information. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| address.city string Optional | City of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| address.country string Optional | Country of the address. This field is returned if it exists in the resource. Allowable Values: 40 char max |
| address.postal_code string Optional | Postal code of the address. This field is returned if it exists in the resource. Allowable Values: 20 char max |
| address.state string Optional | State, province, or territory of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| address.zip string Optional | United States ZIP code of the address. This field is returned if it exists in the resource. Allowable Values: 20 char max |
| birth_date string Optional | Business director’s date of birth. Allowable Values: Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ssZ |
| email string Optional | Email address of the business director. Allowable Values: 1–255 chars |
| first_name string Optional | First or given name of the business director. Allowable Values: 255 char max |
| identifications array of objects Optional | One or more objects containing personal identifications of the business director. Allowable Values: Valid array of one or more identifications objects |
| identifications[].expiration_date string Optional | Expiration date of the identification, if applicable. Allowable Values: Format: yyyy-MM-dd |
| identifications[].type string Required | Type of identification. NOTE: Full Social Security Number (SSN) is required for US-based user cardholder KYC verification, using the SSN type. Full Employer Identification Number (EIN) is required for business cardholder KYC verification, using the BUSINESS_TAX_ID or BUSINESS_NUMBER type. For business directors, use one of SSN, TIN, SIN, or NIN. Nine digits only, no delimiters. 123456789, for example.Allowable Values: SSN, TIN, SIN, NIN, PASSPORT_NUMBER, DRIVERS_LICENSE, BUSINESS_NUMBER, BUSINESS_TAX_ID, TAXPAYER_REFERENCE |
| identifications[].value string Optional | Number associated with the identification. Allowable Values: 255 char max NOTE: Digits only, do not use separators. For example: 123456789 |
| last_name string Optional | Last or family name of the business director. Allowable Values: 255 char max |
| middle_name string Optional | Middle name of the business director. Allowable Values: 40 char max |
| nationality string Optional | Nationality of the business director. Allowable Values: 255 char max |
| phone string Optional | Full phone number of the business director. Allowable Values: 255 char max |
| place_of_birth string Optional | Business director’s place of birth. Allowable Values: 255 char max |
| title string Optional | Title of the business director. Allowable Values: 1–255 chars |
| token string Optional | Unique identifier of the business director resource. Allowable Values: 1–36 chars |
Response body
| Fields | Description |
|---|---|
| active boolean Conditionally returned | Indicates whether the business director is active. Allowable Values: true, false |
| address object Conditionally returned | Address associated with the business. Allowable Values: address1, address2, city, country, postal_code, state, zip |
| address.address1 string Conditionally returned | Street name and number of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| address.address2 string Conditionally returned | Additional address information. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| address.city string Conditionally returned | City of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| address.country string Conditionally returned | Country of the address. This field is returned if it exists in the resource. Allowable Values: 40 char max |
| address.postal_code string Conditionally returned | Postal code of the address. This field is returned if it exists in the resource. Allowable Values: 20 char max |
| address.state string Conditionally returned | State, province, or territory of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| address.zip string Conditionally returned | United States ZIP code of the address. This field is returned if it exists in the resource. Allowable Values: 20 char max |
| birth_date string Conditionally returned | Business director’s date of birth. Allowable Values: Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ssZ |
| created_time datetime Returned | Date and time when the business director resource was created, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| email string Conditionally returned | Email address of the business director. Allowable Values: 255 char max |
| first_name string Conditionally returned | First or given name of the business director. Allowable Values: 255 char max |
| identifications array of objects Conditionally returned | One or more objects containing personal identifications of the business director. Allowable Values: Valid array of one or more identifications objects |
| identifications[].expiration_date string Conditionally returned | Expiration date of the identification, if applicable. Allowable Values: Format: yyyy-MM-dd |
| identifications[].type string Conditionally returned | Type of identification. Allowable Values: SSN, TIN, SIN, NIN, PASSPORT_NUMBER, DRIVERS_LICENSE, BUSINESS_NUMBER, BUSINESS_TAX_ID, TAXPAYER_REFERENCE |
| identifications[].value string Conditionally returned | Number associated with the identification. Allowable Values: 255 char max |
| last_modified_time datetime Returned | Date and time when the business director resource was last modified, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| last_name string Conditionally returned | Last or family name of the business director. Allowable Values: 255 char max |
| middle_name string Conditionally returned | Middle name of the business director. Allowable Values: 255 char max |
| nationality string Conditionally returned | Nationality of the business director. Allowable Values: 255 char max |
| phone string Conditionally returned | Full phone number of the business director. Allowable Values: 255 char max |
| place_of_birth string Conditionally returned | Business director’s place of birth. Allowable Values: 255 char max |
| title string Conditionally returned | Title of the business director. Allowable Values: 255 char max |
| token string Conditionally returned | Unique identifier of the business director resource. Allowable Values: 36 char max |