> ## Documentation Index > Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create business > To change or track the history of a business' status, use the /businesstransitions endpoint. POST/businesses Create a business. The initial status of a newly created business depends on the [Know Your Customer (KYC) requirements](https://www.marqeta.com/docs/core-api/kyc-verification/) of the program or associated [account holder group](https://www.marqeta.com/docs/core-api/account-holder-groups/). | KYC Required | Initial Business State | Business Active on Creation | Business Limitations | | - | - | - | - | | Always | `UNVERIFIED` | No | Cannot load funds. | | Conditionally | `LIMITED` | No | Restricted by rules in `accountholdergroups.pre_kyc_controls`. | | Never | `ACTIVE` | Required | None. | To change or track the history of a business' status, use the `/businesstransitions` endpoint. For more information on status changes, see [Create Business Transition](https://www.marqeta.com/docs/core-api/business-transitions/create-business-transition.md). For information about configuring the required fields for KYC verification, see [Perform KYC](https://www.marqeta.com/docs/core-api/kyc-verification/perform.md). ## Request body | Fields | Description | | - | - | | account\_holder\_group\_token string Optional | Existing account holder group token that associates the specified account holder group with the business. Send a `GET` request to `/accountholdergroups` to retrieve account holder group tokens. **Allowable Values:** 36 char max | | active boolean Optional | Specifies if the business is in the `ACTIVE` state on the Marqeta platform. **Allowable Values:** `true`, `false` **Default value:** `true` | | attestation\_consent boolean Optional | Indicates that the attester agrees that the information provided is correct and truthful. This field is required for KYC verification (US-based accounts only). **Allowable Values:** `true`, `false` | | attestation\_date datetime Optional | Timestamp of the attestation. This field is required for KYC verification (US-based accounts only). **Allowable Values:** Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ssZ | | attester\_name string Optional | Name of the attester for KYC verification. This field is required for KYC verification (US-based accounts only). **Allowable Values:** 64 char max | | attester\_title string Optional | Title of the attester for KYC verification. **Allowable Values:** 64 char max | | beneficial\_owner1 object Optional | Contains information about the beneficial owner of the business, if applicable. This object is required for KYC verification in the United States if the business is private and has a beneficial owner. This object is not required for publicly held businesses. Do not include information about the proprietor or business officer in a `beneficial_owner` object. If the proprietor or officer of the business is also a beneficial owner, you must indicate that in the `proprietor_is_beneficial_owner` field in the body field details of the business. **Allowable Values:** `birth_place`, `dob`, `email`, `first_name`, `home`, `identifications`, `last_name`, `middle_name`, `nationality`, `ownership_percentage`, `phone`, `ssn`, `title` | | beneficial\_owner1.**birth\_place** string Optional | Country of birth of the beneficial owner. **Allowable Values:** 255 char max ISO 3166 two-character country codes. For example, the country code for the United States is `US`. The ISO maintains the [full list of ISO-3166 country codes](https://www.iso.org/iso-3166-country-codes.html). | | beneficial\_owner1.**dob** datetime Optional | Beneficial owner's date of birth. **Allowable Values:** Format: yyyy-MM-dd | | beneficial\_owner1.**email** string Optional | Email address of the beneficial owner. **Allowable Values:** 1–255 chars 255 char max | | beneficial\_owner1.**first\_name** string Optional | First name of the beneficial owner. **Allowable Values:** 2 char min, 36 char max for KYC verification (US-based accounts only); 255 char max otherwise | | beneficial\_owner1.**home** object Optional | Address associated with the business. **Allowable Values:** `address1`, `address2`, `city`, `country`, `postal_code`, `state`, `zip` | | beneficial\_owner1.home.**address1** string Optional | Street name and number of the address. This field is required for KYC verification (US-based accounts only). Cannot perform KYC if set to a PO Box. **Allowable Values:** 35 char max | | beneficial\_owner1.home.**address2** string Optional | Additional address information. **Allowable Values:** 35 char max | | beneficial\_owner1.home.**city** string Optional | City of the address. This field is required for KYC verification (US-based accounts only). **Allowable Values:** 35 char max | | beneficial\_owner1.home.**country** string Optional | Country of the address. **Allowable Values:** 40 char max [ISO alpha-2 country code](https://www.iso.org/iso-3166-country-codes.html) required for KYC verification (`US`, for example); 40 char max otherwise | | beneficial\_owner1.home.**postal\_code** string Optional | Postal code of the address. This field is required for KYC verification (US-based accounts only). **Allowable Values:** 20 char max | | beneficial\_owner1.home.**state** string Optional | State of the address. This field is required for KYC verification (US-based accounts only). **Allowable Values:** 35 char max [Valid two-character abbreviation](https://www.marqeta.com/docs/core-api/kyc-verification/perform.md#_valid_state_provincial_territorial_and_federal_abbreviations) required for KYC verification (`CA` for California, for example). Must be uppercase. | | beneficial\_owner1.home.**zip** string Optional | United States ZIP code of the address. **Allowable Values:** 20 char max | | beneficial\_owner1.**identifications** array of objects Optional | One or more objects containing personal identifications of the beneficial owner. **Allowable Values:** Valid array of one or more `identifications` objects | | beneficial\_owner1.identifications\[].**expiration\_date** string Optional | Expiration date of the identification, if applicable. **Allowable Values:** Format: yyyy-MM-dd | | beneficial\_owner1.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` | | beneficial\_owner1.identifications\[].**value** string Optional | Number associated with the identification. **Allowable Values:** 255 char max **NOTE:** Digits only, do not use separators. For example: 123456789 | | beneficial\_owner1.**last\_name** string Optional | Last name of the beneficial owner. **Allowable Values:** 2 char min, 48 char max for KYC verification (US-based accounts only); 255 char max otherwise | | beneficial\_owner1.**middle\_name** string Optional | Middle name of the beneficial owner. **Allowable Values:** 255 char max | | beneficial\_owner1.**nationality** string Optional | Nationality of the beneficial owner. **Allowable Values:** 255 char max ISO 3166 two-character country codes. For example, the country code for the United States is `US`. The ISO maintains the [full list of ISO-3166 country codes](https://www.iso.org/iso-3166-country-codes.html). | | beneficial\_owner1.**ownership\_percentage** string Optional | Ownership percentage of the beneficial owner. **Allowable Values:** Any number between 1 and 100. Decimal values are supported; do not include a percentage symbol. | | beneficial\_owner1.**phone** string Optional | Ten-digit phone number of the beneficial owner. **Allowable Values:** Format: 510-555-1212 or 5105551212 | | beneficial\_owner1.**ssn** string Optional | Nine-digit Social Security Number (SSN) or Individual Taxpayer Identification Number (ITIN) of the beneficial owner. **Allowable Values:** Digits only, do not use separators. For example: 123456789 | | beneficial\_owner1.**title** string Optional | Title of the beneficial owner. **Allowable Values:** 255 char max | | beneficial\_owner2 object Optional | Contains information about the beneficial owner of the business, if applicable. This object is required for KYC verification in the United States if the business is private and has a beneficial owner. This object is not required for publicly held businesses. Do not include information about the proprietor or business officer in a `beneficial_owner` object. If the proprietor or officer of the business is also a beneficial owner, you must indicate that in the `proprietor_is_beneficial_owner` field in the body field details of the business. **Allowable Values:** `birth_place`, `dob`, `email`, `first_name`, `home`, `identifications`, `last_name`, `middle_name`, `nationality`, `ownership_percentage`, `phone`, `ssn`, `title` | | beneficial\_owner2.**birth\_place** string Optional | Country of birth of the beneficial owner. **Allowable Values:** 255 char max ISO 3166 two-character country codes. For example, the country code for the United States is `US`. The ISO maintains the [full list of ISO-3166 country codes](https://www.iso.org/iso-3166-country-codes.html). | | beneficial\_owner2.**dob** datetime Optional | Beneficial owner's date of birth. **Allowable Values:** Format: yyyy-MM-dd | | beneficial\_owner2.**email** string Optional | Email address of the beneficial owner. **Allowable Values:** 1–255 chars 255 char max | | beneficial\_owner2.**first\_name** string Optional | First name of the beneficial owner. **Allowable Values:** 2 char min, 36 char max for KYC verification (US-based accounts only); 255 char max otherwise | | beneficial\_owner2.**home** object Optional | Address associated with the business. **Allowable Values:** `address1`, `address2`, `city`, `country`, `postal_code`, `state`, `zip` | | beneficial\_owner2.home.**address1** string Optional | Street name and number of the address. This field is required for KYC verification (US-based accounts only). Cannot perform KYC if set to a PO Box. **Allowable Values:** 35 char max | | beneficial\_owner2.home.**address2** string Optional | Additional address information. **Allowable Values:** 35 char max | | beneficial\_owner2.home.**city** string Optional | City of the address. This field is required for KYC verification (US-based accounts only). **Allowable Values:** 35 char max | | beneficial\_owner2.home.**country** string Optional | Country of the address. **Allowable Values:** 40 char max [ISO alpha-2 country code](https://www.iso.org/iso-3166-country-codes.html) required for KYC verification (`US`, for example); 40 char max otherwise | | beneficial\_owner2.home.**postal\_code** string Optional | Postal code of the address. This field is required for KYC verification (US-based accounts only). **Allowable Values:** 20 char max | | beneficial\_owner2.home.**state** string Optional | State of the address. This field is required for KYC verification (US-based accounts only). **Allowable Values:** 35 char max [Valid two-character abbreviation](https://www.marqeta.com/docs/core-api/kyc-verification/perform.md#_valid_state_provincial_territorial_and_federal_abbreviations) required for KYC verification (`CA` for California, for example). Must be uppercase. | | beneficial\_owner2.home.**zip** string Optional | United States ZIP code of the address. **Allowable Values:** 20 char max | | beneficial\_owner2.**identifications** array of objects Optional | One or more objects containing personal identifications of the beneficial owner. **Allowable Values:** Valid array of one or more `identifications` objects | | beneficial\_owner2.identifications\[].**expiration\_date** string Optional | Expiration date of the identification, if applicable. **Allowable Values:** Format: yyyy-MM-dd | | beneficial\_owner2.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` | | beneficial\_owner2.identifications\[].**value** string Optional | Number associated with the identification. **Allowable Values:** 255 char max **NOTE:** Digits only, do not use separators. For example: 123456789 | | beneficial\_owner2.**last\_name** string Optional | Last name of the beneficial owner. **Allowable Values:** 2 char min, 48 char max for KYC verification (US-based accounts only); 255 char max otherwise | | beneficial\_owner2.**middle\_name** string Optional | Middle name of the beneficial owner. **Allowable Values:** 255 char max | | beneficial\_owner2.**nationality** string Optional | Nationality of the beneficial owner. **Allowable Values:** 255 char max ISO 3166 two-character country codes. For example, the country code for the United States is `US`. The ISO maintains the [full list of ISO-3166 country codes](https://www.iso.org/iso-3166-country-codes.html). | | beneficial\_owner2.**ownership\_percentage** string Optional | Ownership percentage of the beneficial owner. **Allowable Values:** Any number between 1 and 100. Decimal values are supported; do not include a percentage symbol. | | beneficial\_owner2.**phone** string Optional | Ten-digit phone number of the beneficial owner. **Allowable Values:** Format: 510-555-1212 or 5105551212 | | beneficial\_owner2.**ssn** string Optional | Nine-digit Social Security Number (SSN) or Individual Taxpayer Identification Number (ITIN) of the beneficial owner. **Allowable Values:** Digits only, do not use separators. For example: 123456789 | | beneficial\_owner2.**title** string Optional | Title of the beneficial owner. **Allowable Values:** 255 char max | | beneficial\_owner3 object Optional | Contains information about the beneficial owner of the business, if applicable. This object is required for KYC verification in the United States if the business is private and has a beneficial owner. This object is not required for publicly held businesses. Do not include information about the proprietor or business officer in a `beneficial_owner` object. If the proprietor or officer of the business is also a beneficial owner, you must indicate that in the `proprietor_is_beneficial_owner` field in the body field details of the business. **Allowable Values:** `birth_place`, `dob`, `email`, `first_name`, `home`, `identifications`, `last_name`, `middle_name`, `nationality`, `ownership_percentage`, `phone`, `ssn`, `title` | | beneficial\_owner3.**birth\_place** string Optional | Country of birth of the beneficial owner. **Allowable Values:** 255 char max ISO 3166 two-character country codes. For example, the country code for the United States is `US`. The ISO maintains the [full list of ISO-3166 country codes](https://www.iso.org/iso-3166-country-codes.html). | | beneficial\_owner3.**dob** datetime Optional | Beneficial owner's date of birth. **Allowable Values:** Format: yyyy-MM-dd | | beneficial\_owner3.**email** string Optional | Email address of the beneficial owner. **Allowable Values:** 1–255 chars 255 char max | | beneficial\_owner3.**first\_name** string Optional | First name of the beneficial owner. **Allowable Values:** 2 char min, 36 char max for KYC verification (US-based accounts only); 255 char max otherwise | | beneficial\_owner3.**home** object Optional | Address associated with the business. **Allowable Values:** `address1`, `address2`, `city`, `country`, `postal_code`, `state`, `zip` | | beneficial\_owner3.home.**address1** string Optional | Street name and number of the address. This field is required for KYC verification (US-based accounts only). Cannot perform KYC if set to a PO Box. **Allowable Values:** 35 char max | | beneficial\_owner3.home.**address2** string Optional | Additional address information. **Allowable Values:** 35 char max | | beneficial\_owner3.home.**city** string Optional | City of the address. This field is required for KYC verification (US-based accounts only). **Allowable Values:** 35 char max | | beneficial\_owner3.home.**country** string Optional | Country of the address. **Allowable Values:** 40 char max [ISO alpha-2 country code](https://www.iso.org/iso-3166-country-codes.html) required for KYC verification (`US`, for example); 40 char max otherwise | | beneficial\_owner3.home.**postal\_code** string Optional | Postal code of the address. This field is required for KYC verification (US-based accounts only). **Allowable Values:** 20 char max | | beneficial\_owner3.home.**state** string Optional | State of the address. This field is required for KYC verification (US-based accounts only). **Allowable Values:** 35 char max [Valid two-character abbreviation](https://www.marqeta.com/docs/core-api/kyc-verification/perform.md#_valid_state_provincial_territorial_and_federal_abbreviations) required for KYC verification (`CA` for California, for example). Must be uppercase. | | beneficial\_owner3.home.**zip** string Optional | United States ZIP code of the address. **Allowable Values:** 20 char max | | beneficial\_owner3.**identifications** array of objects Optional | One or more objects containing personal identifications of the beneficial owner. **Allowable Values:** Valid array of one or more `identifications` objects | | beneficial\_owner3.identifications\[].**expiration\_date** string Optional | Expiration date of the identification, if applicable. **Allowable Values:** Format: yyyy-MM-dd | | beneficial\_owner3.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` | | beneficial\_owner3.identifications\[].**value** string Optional | Number associated with the identification. **Allowable Values:** 255 char max **NOTE:** Digits only, do not use separators. For example: 123456789 | | beneficial\_owner3.**last\_name** string Optional | Last name of the beneficial owner. **Allowable Values:** 2 char min, 48 char max for KYC verification (US-based accounts only); 255 char max otherwise | | beneficial\_owner3.**middle\_name** string Optional | Middle name of the beneficial owner. **Allowable Values:** 255 char max | | beneficial\_owner3.**nationality** string Optional | Nationality of the beneficial owner. **Allowable Values:** 255 char max ISO 3166 two-character country codes. For example, the country code for the United States is `US`. The ISO maintains the [full list of ISO-3166 country codes](https://www.iso.org/iso-3166-country-codes.html). | | beneficial\_owner3.**ownership\_percentage** string Optional | Ownership percentage of the beneficial owner. **Allowable Values:** Any number between 1 and 100. Decimal values are supported; do not include a percentage symbol. | | beneficial\_owner3.**phone** string Optional | Ten-digit phone number of the beneficial owner. **Allowable Values:** Format: 510-555-1212 or 5105551212 | | beneficial\_owner3.**ssn** string Optional | Nine-digit Social Security Number (SSN) or Individual Taxpayer Identification Number (ITIN) of the beneficial owner. **Allowable Values:** Digits only, do not use separators. For example: 123456789 | | beneficial\_owner3.**title** string Optional | Title of the beneficial owner. **Allowable Values:** 255 char max | | beneficial\_owner4 object Optional | Contains information about the beneficial owner of the business, if applicable. This object is required for KYC verification in the United States if the business is private and has a beneficial owner. This object is not required for publicly held businesses. Do not include information about the proprietor or business officer in a `beneficial_owner` object. If the proprietor or officer of the business is also a beneficial owner, you must indicate that in the `proprietor_is_beneficial_owner` field in the body field details of the business. **Allowable Values:** `birth_place`, `dob`, `email`, `first_name`, `home`, `identifications`, `last_name`, `middle_name`, `nationality`, `ownership_percentage`, `phone`, `ssn`, `title` | | beneficial\_owner4.**birth\_place** string Optional | Country of birth of the beneficial owner. **Allowable Values:** 255 char max ISO 3166 two-character country codes. For example, the country code for the United States is `US`. The ISO maintains the [full list of ISO-3166 country codes](https://www.iso.org/iso-3166-country-codes.html). | | beneficial\_owner4.**dob** datetime Optional | Beneficial owner's date of birth. **Allowable Values:** Format: yyyy-MM-dd | | beneficial\_owner4.**email** string Optional | Email address of the beneficial owner. **Allowable Values:** 1–255 chars 255 char max | | beneficial\_owner4.**first\_name** string Optional | First name of the beneficial owner. **Allowable Values:** 2 char min, 36 char max for KYC verification (US-based accounts only); 255 char max otherwise | | beneficial\_owner4.**home** object Optional | Address associated with the business. **Allowable Values:** `address1`, `address2`, `city`, `country`, `postal_code`, `state`, `zip` | | beneficial\_owner4.home.**address1** string Optional | Street name and number of the address. This field is required for KYC verification (US-based accounts only). Cannot perform KYC if set to a PO Box. **Allowable Values:** 35 char max | | beneficial\_owner4.home.**address2** string Optional | Additional address information. **Allowable Values:** 35 char max | | beneficial\_owner4.home.**city** string Optional | City of the address. This field is required for KYC verification (US-based accounts only). **Allowable Values:** 35 char max | | beneficial\_owner4.home.**country** string Optional | Country of the address. **Allowable Values:** 40 char max [ISO alpha-2 country code](https://www.iso.org/iso-3166-country-codes.html) required for KYC verification (`US`, for example); 40 char max otherwise | | beneficial\_owner4.home.**postal\_code** string Optional | Postal code of the address. This field is required for KYC verification (US-based accounts only). **Allowable Values:** 20 char max | | beneficial\_owner4.home.**state** string Optional | State of the address. This field is required for KYC verification (US-based accounts only). **Allowable Values:** 35 char max [Valid two-character abbreviation](https://www.marqeta.com/docs/core-api/kyc-verification/perform.md#_valid_state_provincial_territorial_and_federal_abbreviations) required for KYC verification (`CA` for California, for example). Must be uppercase. | | beneficial\_owner4.home.**zip** string Optional | United States ZIP code of the address. **Allowable Values:** 20 char max | | beneficial\_owner4.**identifications** array of objects Optional | One or more objects containing personal identifications of the beneficial owner. **Allowable Values:** Valid array of one or more `identifications` objects | | beneficial\_owner4.identifications\[].**expiration\_date** string Optional | Expiration date of the identification, if applicable. **Allowable Values:** Format: yyyy-MM-dd | | beneficial\_owner4.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` | | beneficial\_owner4.identifications\[].**value** string Optional | Number associated with the identification. **Allowable Values:** 255 char max **NOTE:** Digits only, do not use separators. For example: 123456789 | | beneficial\_owner4.**last\_name** string Optional | Last name of the beneficial owner. **Allowable Values:** 2 char min, 48 char max for KYC verification (US-based accounts only); 255 char max otherwise | | beneficial\_owner4.**middle\_name** string Optional | Middle name of the beneficial owner. **Allowable Values:** 255 char max | | beneficial\_owner4.**nationality** string Optional | Nationality of the beneficial owner. **Allowable Values:** 255 char max ISO 3166 two-character country codes. For example, the country code for the United States is `US`. The ISO maintains the [full list of ISO-3166 country codes](https://www.iso.org/iso-3166-country-codes.html). | | beneficial\_owner4.**ownership\_percentage** string Optional | Ownership percentage of the beneficial owner. **Allowable Values:** Any number between 1 and 100. Decimal values are supported; do not include a percentage symbol. | | beneficial\_owner4.**phone** string Optional | Ten-digit phone number of the beneficial owner. **Allowable Values:** Format: 510-555-1212 or 5105551212 | | beneficial\_owner4.**ssn** string Optional | Nine-digit Social Security Number (SSN) or Individual Taxpayer Identification Number (ITIN) of the beneficial owner. **Allowable Values:** Digits only, do not use separators. For example: 123456789 | | beneficial\_owner4.**title** string Optional | Title of the beneficial owner. **Allowable Values:** 255 char max | | business\_name\_dba string Optional | Fictitious business name ("Doing Business As" or DBA). This field is required for KYC verification (US-based accounts only). If your business does not use a fictitious business name, enter your legal business name again in this field. **Allowable Values:** 255 char max 128 char max for KYC verification; 255 char max otherwise | | business\_name\_legal string Optional | Legal name of business. This field is required for KYC verification (US-based accounts only). **Allowable Values:** 255 char max 128 char max for KYC verification; 255 char max otherwise | | business\_type string Optional | Indicates the type of business, for example B2B (business-to-business) or B2C (business-to-consumer). **Allowable Values:** 255 char max | | date\_established datetime Optional | Date when the business was established. **Allowable Values:** Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ssZ | | duns\_number string Optional | Data Universal Numbering System (DUNS) number of the business. **Allowable Values:** 255 char max | | general\_business\_description string Optional | Required for KYC verification (US-based cardholders only). Business description must adhere to the [NAICS standard](https://www.census.gov/naics/), as defined by the United States Census Bureau. You must provide at least the description; NAICS codes are optional. For example, `Used Car Dealers` or `44112 - Used Car Dealers`. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | history string Optional | History of the business. **Allowable Values:** 255 char max | | identifications array of objects Optional | One or more objects containing identifications associated with the business. **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 | | in\_current\_location\_since datetime Optional | Date on which the business office opened in its current location. **Allowable Values:** Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ssZ | | incorporation object Optional | Contains information about the organizational structure of the business. This object is required for KYC verification (US-based accounts only). **Allowable Values:** `address_registered_under`, `incorporation_type`, `is_public`, `is_regulated_entity`, `name_registered_under`, `state_of_incorporation`, `stock_symbol` | | incorporation.**address\_registered\_under** object Optional | Address associated with the business. **Allowable Values:** `address1`, `address2`, `city`, `country`, `postal_code`, `state`, `zip` | | incorporation.address\_registered\_under.**address1** string Optional | Street name and number of the address. This field is required for KYC verification (US-based accounts only). Cannot perform KYC if set to a PO Box. **Allowable Values:** 35 char max | | incorporation.address\_registered\_under.**address2** string Optional | Additional address information. **Allowable Values:** 35 char max | | incorporation.address\_registered\_under.**city** string Optional | City of the address. This field is required for KYC verification (US-based accounts only). **Allowable Values:** 35 char max | | incorporation.address\_registered\_under.**country** string Optional | Country of the address. **Allowable Values:** 40 char max [ISO alpha-2 country code](https://www.iso.org/iso-3166-country-codes.html) required for KYC verification (`US`, for example); 40 char max otherwise | | incorporation.address\_registered\_under.**postal\_code** string Optional | Postal code of the address. This field is required for KYC verification (US-based accounts only). **Allowable Values:** 20 char max | | incorporation.address\_registered\_under.**state** string Optional | State of the address. This field is required for KYC verification (US-based accounts only). **Allowable Values:** 35 char max [Valid two-character abbreviation](https://www.marqeta.com/docs/core-api/kyc-verification/perform.md#_valid_state_provincial_territorial_and_federal_abbreviations) required for KYC verification (`CA` for California, for example). Must be uppercase. | | incorporation.address\_registered\_under.**zip** string Optional | United States ZIP code of the address. **Allowable Values:** 20 char max | | incorporation.**incorporation\_type** string Optional | Organizational structure of the business, such as corporation or sole proprietorship. This field is required for KYC verification (US-based accounts only). **Allowable Values:** `LLC`, `CORPORATION`, `SOLE_PROPRIETORSHIP`, `PARTNERSHIP`, `COOPERATIVE`, `OTHER`, `FINANCIAL_OR_CREDIT_INSTITUTION`, `FOUNDATION`, `ASSOCIATION`, `CHARITY`, `TRUST` | | incorporation.**is\_public** boolean Optional | A value of `true` indicates that the business is publicly held. **Allowable Values:** `true`, `false` **Default value:** `false` | | incorporation.**is\_regulated\_entity** boolean Optional | A value of `true` indicates that the business is a regulated entity. **Allowable Values:** `true`, `false` | | incorporation.**name\_registered\_under** string Optional | Name under which the business is registered. **Allowable Values:** 255 char max | | incorporation.**state\_of\_incorporation** string Optional | State, province, territory, or federation where the business is incorporated. This field is required for KYC verification (US-based accounts only). **Allowable Values:** 255 char max [Valid state, provincial, territorial, or federal abbreviation](https://www.marqeta.com/docs/core-api/kyc-verification/perform.md#_valid_state_provincial_territorial_and_federal_abbreviations) required for KYC verification (`CA` for California or `CAN` for Canada, for example); 255 char max otherwise | | incorporation.**stock\_symbol** string Optional | Business stock symbol. **Allowable Values:** 255 char max | | international\_office\_locations string Optional | Locations of the business' offices outside the US. **Allowable Values:** 255 char max | | ip\_address string Optional | IP address of the business. **Allowable Values:** 39 char max | | metadata object Optional | Associates any additional metadata you provide with the business. **Allowable Values:** You can define the names and values of up to 20 fields in the format `"my_name_1": "my_value_1"` | | notes string Optional | Any additional information pertaining to the business. **Allowable Values:** 255 char max | | office\_location object Optional | Address associated with the business. **Allowable Values:** `address1`, `address2`, `city`, `country`, `postal_code`, `state`, `zip` | | office\_location.**address1** string Optional | Street name and number of the address. This field is required for KYC verification (US-based accounts only). Cannot perform KYC if set to a PO Box. **Allowable Values:** 35 char max | | office\_location.**address2** string Optional | Additional address information. **Allowable Values:** 35 char max | | office\_location.**city** string Optional | City of the address. This field is required for KYC verification (US-based accounts only). **Allowable Values:** 35 char max | | office\_location.**country** string Optional | Country of the address. **Allowable Values:** 40 char max [ISO alpha-2 country code](https://www.iso.org/iso-3166-country-codes.html) required for KYC verification (`US`, for example); 40 char max otherwise | | office\_location.**postal\_code** string Optional | Postal code of the address. This field is required for KYC verification (US-based accounts only). **Allowable Values:** 20 char max | | office\_location.**state** string Optional | State of the address. This field is required for KYC verification (US-based accounts only). **Allowable Values:** 35 char max [Valid two-character abbreviation](https://www.marqeta.com/docs/core-api/kyc-verification/perform.md#_valid_state_provincial_territorial_and_federal_abbreviations) required for KYC verification (`CA` for California, for example). Must be uppercase. | | office\_location.**zip** string Optional | United States ZIP code of the address. **Allowable Values:** 20 char max | | password string Optional | Password for the business account on the Marqeta platform. **Allowable Values:** 1–255 chars - Must contain at least one numeral - Must contain at least one lowercase letter - Must contain at least one uppercase letter - Must contain at least one of these symbols: `@``#``$``%``!``^``&``*``(``)` `\\``_``+``~``-``=``[``]``\{``}` `,``;``:``'``"``.``/``<``>``?``\` | | phone string Optional | 10-digit telephone number of business. **Allowable Values:** 255 char max Format: 510-555-1212 or 5105551212 | | primary\_contact object Optional | Describes the business' primary contact person. **Allowable Values:** `department`, `email`, `extension`, `fax`, `full_name`, `mobile`, `phone`, `title` | | primary\_contact.**department** string Optional | Business department of the primary contact. **Allowable Values:** 255 char max | | primary\_contact.**email** string Optional | Email address of the primary contact. **Allowable Values:** 255 char max | | primary\_contact.**extension** string Optional | Phone extension of the primary contact. **Allowable Values:** 255 char max | | primary\_contact.**fax** string Optional | Fax number of the primary contact. **Allowable Values:** 255 char max Format: 510-555-1212 or 5105551212 | | primary\_contact.**full\_name** string Optional | Full name of the primary contact. **Allowable Values:** 255 char max | | primary\_contact.**mobile** string Optional | Mobile phone number of the primary contact. **Allowable Values:** 255 char max Format: 510-555-1212 or 5105551212 | | primary\_contact.**phone** string Optional | Phone number of the primary contact. **Allowable Values:** 255 char max Format: 510-555-1212 or 5105551212 | | primary\_contact.**title** string Optional | Title of the primary contact. **Allowable Values:** 255 char max | | proprietor\_is\_beneficial\_owner boolean Optional | Indicates that the proprietor or officer of the business is also a beneficial owner. This field is required for KYC verification if the business proprietor or officer is also a beneficial owner. **Allowable Values:** `true`, `false` **Default value:** `false` | | proprietor\_or\_officer object Optional | Contains information about the proprietor or officer of the business. This object is required for KYC verification of proprietors or officers of privately held businesses in the United States. This object is not required for publicly held businesses. **Allowable Values:** `alternative_names`, `birth_place`, `dob`, `email`, `first_name`, `home`, `identifications`, `last_name`, `middle_name`, `nationality`, `phone`, `ssn`, `title` | | proprietor\_or\_officer.**alternative\_names** string Optional | Alternate names of the business proprietor or officer. **Allowable Values:** 255 char max | | proprietor\_or\_officer.**birth\_place** string Optional | Country of birth of the business proprietor or officer. **Allowable Values:** 255 char max ISO 3166 two-character country codes. For example, the country code for the United States is `US`. The ISO maintains the [full list of ISO-3166 country codes](https://www.iso.org/iso-3166-country-codes.html). | | proprietor\_or\_officer.**dob** datetime Optional | Business proprietor or officer's date of birth. This field is required for KYC verification (US-based accounts only). **Allowable Values:** Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ssZ | | proprietor\_or\_officer.**email** string Optional | Email address of the business proprietor or officer. **Allowable Values:** 255 char max | | proprietor\_or\_officer.**first\_name** string Required | First name of business proprietor or officer. **Allowable Values:** 2 char min, 36 char max for KYC verification (US-based accounts only); 255 char max otherwise | | proprietor\_or\_officer.**home** object Optional | Address associated with the business. **Allowable Values:** `address1`, `address2`, `city`, `country`, `postal_code`, `state`, `zip` | | proprietor\_or\_officer.home.**address1** string Optional | Street name and number of the address. This field is required for KYC verification (US-based accounts only). Cannot perform KYC if set to a PO Box. **Allowable Values:** 35 char max | | proprietor\_or\_officer.home.**address2** string Optional | Additional address information. **Allowable Values:** 35 char max | | proprietor\_or\_officer.home.**city** string Optional | City of the address. This field is required for KYC verification (US-based accounts only). **Allowable Values:** 35 char max | | proprietor\_or\_officer.home.**country** string Optional | Country of the address. **Allowable Values:** 40 char max [ISO alpha-2 country code](https://www.iso.org/iso-3166-country-codes.html) required for KYC verification (`US`, for example); 40 char max otherwise | | proprietor\_or\_officer.home.**postal\_code** string Optional | Postal code of the address. This field is required for KYC verification (US-based accounts only). **Allowable Values:** 20 char max | | proprietor\_or\_officer.home.**state** string Optional | State of the address. This field is required for KYC verification (US-based accounts only). **Allowable Values:** 35 char max [Valid two-character abbreviation](https://www.marqeta.com/docs/core-api/kyc-verification/perform.md#_valid_state_provincial_territorial_and_federal_abbreviations) required for KYC verification (`CA` for California, for example). Must be uppercase. | | proprietor\_or\_officer.home.**zip** string Optional | United States ZIP code of the address. **Allowable Values:** 20 char max | | proprietor\_or\_officer.**identifications** array of objects Optional | One or more objects containing personal identifications of the business proprietor or officer. **Allowable Values:** Valid array of one or more `identifications` objects | | proprietor\_or\_officer.identifications\[].**expiration\_date** string Optional | Expiration date of the identification, if applicable. **Allowable Values:** Format: yyyy-MM-dd | | proprietor\_or\_officer.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` | | proprietor\_or\_officer.identifications\[].**value** string Optional | Number associated with the identification. **Allowable Values:** 255 char max **NOTE:** Digits only, do not use separators. For example: 123456789 | | proprietor\_or\_officer.**last\_name** string Required | Last name of business proprietor or officer. **Allowable Values:** 2 char min, 48 char max for KYC verification (US-based accounts only); 255 char max otherwise | | proprietor\_or\_officer.**middle\_name** string Optional | Middle name of business proprietor or officer. **Allowable Values:** 255 char max | | proprietor\_or\_officer.**nationality** string Optional | Nationality of the business proprietor or officer. **Allowable Values:** 255 char max ISO 3166 two-character country codes. For example, the country code for the United States is `US`. The ISO maintains the [full list of ISO-3166 country codes](https://www.iso.org/iso-3166-country-codes.html). | | proprietor\_or\_officer.**phone** string Optional | Telephone number of the business proprietor or officer. **Allowable Values:** Format: 510-555-1212 or 5105551212 Do not insert a 1 before the area code. | | proprietor\_or\_officer.**ssn** string Optional | Social Security Number (SSN) or Individual Taxpayer Identification Number (ITIN) of the business proprietor or officer. **Allowable Values:** Nine digits, no delimiters. `123456789`, for example. | | proprietor\_or\_officer.**title** string Optional | Title of business proprietor or officer. **Allowable Values:** 255 char max | | taxpayer\_id string Optional | Taxpayer identifier of the business. **Allowable Values:** 255 char max | | token string Optional | Unique identifier of the business resource. If you do not include a token, the system generates one automatically. This token is necessary for use in other API calls, so we recommend that rather than let the system generate one, you use a simple string that is easy to remember. This value cannot be updated. **Allowable Values:** 1–36 chars | | website string Optional | URL of the business' website. **Allowable Values:** 255 char max | ## Sample request body ```json JSON expandable lines wrap theme={null} { "token": "my_business_02", "metadata": { "my_name_1": "my_value_1", "my_name_2": "my_value_2" }, "notes": "My notes", "password": "My_passw0rd", "phone": "5105551212", "website": "https://my_business_02.com", "history": "My_business_history", "incorporation": { "is_public": true, "stock_symbol": "MB", "state_of_incorporation": "CA", "name_registered_under": "First Middle Last", "address_registered_under": { "address1": "123 B Street", "city": "Oakland", "state": "CA", "postal_code": "94610", "country": "US" }, "incorporation_type": "LLC" }, "ip_address": "67.120.28.118,", "business_name_legal": "My_legal_business_name", "business_name_dba": "My_fictitious_business_name", "office_location": { "address1": "123 A street", "address2": "Suite 123", "city": "Oakland", "state": "CA", "postal_code": "94610", "country": "US" }, "in_current_location_since": "2010-04-15T00:01:00Z", "date_established": "2010-04-15T00:01:00Z", "general_business_description": "44112 - Used Car Dealers", "business_type": "My_business_type", "international_office_locations": "Athens, Greece; Buenos Aires, Argentina", "identifications": [ { "type": "BUSINESS_TAX_ID", "value": "123456789" } ], "duns_number": "987654321", "primary_contact": { "title": "Dr", "department": "My_department", "phone": "5105551212", "extension": "11", "fax": "5105551222", "email": "dr.me@my.business.com", "full_name": "First Middle Last", "mobile": "5105551213" }, "proprietor_or_officer": { "title": "Mr", "dob": "1985-01-08T00:00:00Z", "phone": "5105551211", "email": "mr.myself@my.business.com", "first_name": "First", "middle_name": "Middle", "last_name": "Last", "alternative_names": "My Alternative Name", "ssn": "5555", "home": { "address1": "123 B Street", "address2": "Apt A", "city": "Oakland", "state": "CA", "postal_code": "94610", "country": "US" } }, "beneficial_owner1": { "title": "Ms", "dob": "1982-07-23T05:36:00Z", "ssn": "123456789", "phone": "5105551212", "first_name": "First", "middle_name": "Middle", "last_name": "Last", "home": { "address1": "123 B Street", "address2": "Apt A", "city": "Oakland", "state": "CA", "postal_code": "94610", "country": "US" } }, "beneficial_owner2": { "title": "Ms", "dob": "1973-11-11T11:11:11Z", "ssn": "234567891", "phone": "5105551213", "first_name": "First", "middle_name": "Middle", "last_name": "Last", "home": { "address1": "4321 Grove Street", "address2": "Suite 123", "city": "Oakland", "state": "CA", "postal_code": "94610", "country": "US" } }, "beneficial_owner3": { "title": "Ms", "dob": "1981-02-14T15:16:17Z", "ssn": "345678912", "phone": "5105551214", "first_name": "First", "middle_name": "Middle", "last_name": "Last", "home": { "address1": "789 Pulgas Ave", "city": "Oakland", "state": "CA", "postal_code": "94610", "country": "US" } }, "beneficial_owner4": { "title": "Dr", "dob": "1954-03-07T15:16:17Z", "ssn": "456789123", "phone": "5105551215", "first_name": "First", "middle_name": "Middle", "last_name": "Last", "home": { "address1": "16 Poplar Street", "city": "Oakland", "state": "CA", "postal_code": "94610", "country": "US" } }, "attester_name": "Jane Smith", "attester_title": "Chief Executive Officer", "attestation_date": "2025-03-03T00:01:00Z" } ``` ## Response body | Fields | Description | | - | - | | account\_holder\_group\_token string Conditionally returned | Associates the specified account holder group with the business. This field is returned if it exists in the resource. **Allowable Values:** 36 char max | | active boolean Conditionally returned | Specifies if the business is in the `ACTIVE` state on the Marqeta platform. This field is returned if it exists in the resource. **Allowable Values:** `true`, `false` | | attestation\_consent boolean Conditionally returned | Indicates that the attester agrees that the information provided is correct and truthful. This field is returned if it exists in the resource. **Allowable Values:** `true`, `false` | | attestation\_date datetime Conditionally returned | Timestamp of the attestation. This field is returned if it exists in the resource. **Allowable Values:** Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ssZ | | attester\_name string Conditionally returned | Name of the attester for KYC verification. This field is returned if it exists in the resource. **Allowable Values:** 64 char max | | attester\_title string Conditionally returned | Title of the attester for KYC verification. This field is returned if it exists in the resource. **Allowable Values:** 64 char max | | authentication object Conditionally returned | Contains metadata about the business's email verification and password updates. **Allowable Values:** `email_verified`, `email_verified_time`, `last_password_update_channel`, `last_password_update_time` | | authentication.**email\_verified** boolean Conditionally returned | Specifies whether the email address has been verified. **Allowable Values:** `true`, `false` | | authentication.**email\_verified\_time** datetime Conditionally returned | Date and time when the email address was verified. **Allowable Values:** datetime **Format:** yyyy-MM-ddThh:mm:ssZ | | authentication.**last\_password\_update\_channel** string Conditionally returned | Specifies the channel through which the password was last changed. **Allowable Values:** `USER_CHANGE`, `USER_RESET` | | authentication.**last\_password\_update\_time** datetime Conditionally returned | Date and time when the password was last changed. **Allowable Values:** datetime **Format:** yyyy-MM-ddThh:mm:ssZ | | beneficial\_owner1 object Conditionally returned | Contains information about the beneficial owner of the business, if applicable. **Allowable Values:** `birth_place`, `dob`, `email`, `first_name`, `home`, `identifications`, `last_name`, `middle_name`, `nationality`, `ownership_percentage`, `phone`, `ssn`, `title` | | beneficial\_owner1.**birth\_place** string Conditionally returned | Country of birth of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max ISO 3166 two-character country code | | beneficial\_owner1.**first\_name** string Conditionally returned | First name of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | beneficial\_owner1.**email** string Conditionally returned | Email address of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | beneficial\_owner1.**dob** datetime Conditionally returned | Date of birth of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** Format: yyyy-MM-dd | | beneficial\_owner1.**home** object Conditionally returned | Address associated with the business. **Allowable Values:** `address1`, `address2`, `city`, `country`, `postal_code`, `state`, `zip` | | beneficial\_owner1.home.**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 | | beneficial\_owner1.home.**address2** string Conditionally returned | Additional address information. This field is returned if it exists in the resource. **Allowable Values:** 35 char max | | beneficial\_owner1.home.**city** string Conditionally returned | City of the address. This field is returned if it exists in the resource. **Allowable Values:** 35 char max | | beneficial\_owner1.home.**country** string Conditionally returned | Country of the address. This field is returned if it exists in the resource. **Allowable Values:** 40 char max | | beneficial\_owner1.home.**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 | | beneficial\_owner1.home.**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 | | beneficial\_owner1.home.**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 | | beneficial\_owner1.**identifications** array of objects Conditionally returned | One or more objects containing personal identifications of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** Valid array of one or more `identifications` objects | | beneficial\_owner1.identifications\[].**expiration\_date** string Conditionally returned | Expiration date of the identification, if applicable. **Allowable Values:** Format: yyyy-MM-dd | | beneficial\_owner1.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` | | beneficial\_owner1.identifications\[].**value** string Conditionally returned | Number associated with the identification. **Allowable Values:** 255 char max | | beneficial\_owner1.**last\_name** string Conditionally returned | Last name of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | beneficial\_owner1.**middle\_name** string Conditionally returned | Middle name of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | beneficial\_owner1.**nationality** string Conditionally returned | Nationality of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max ISO 3166 two-character country code | | beneficial\_owner1.**ownership\_percentage** string Conditionally returned | Ownership percentage of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** A number between 1 and 100 | | beneficial\_owner1.**phone** string Conditionally returned | Ten-digit phone number of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** Format: 510-555-1212 or 5105551212 | | beneficial\_owner1.**ssn** string Conditionally returned | Nine-digit Social Security Number (SSN) or Individual Taxpayer Identification Number (ITIN) of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** Nine digits | | beneficial\_owner1.**title** string Conditionally returned | Title of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | beneficial\_owner2 object Conditionally returned | Contains information about the beneficial owner of the business, if applicable. **Allowable Values:** `birth_place`, `dob`, `email`, `first_name`, `home`, `identifications`, `last_name`, `middle_name`, `nationality`, `ownership_percentage`, `phone`, `ssn`, `title` | | beneficial\_owner2.**birth\_place** string Conditionally returned | Country of birth of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max ISO 3166 two-character country code | | beneficial\_owner2.**first\_name** string Conditionally returned | First name of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | beneficial\_owner2.**email** string Conditionally returned | Email address of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | beneficial\_owner2.**dob** datetime Conditionally returned | Date of birth of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** Format: yyyy-MM-dd | | beneficial\_owner2.**home** object Conditionally returned | Address associated with the business. **Allowable Values:** `address1`, `address2`, `city`, `country`, `postal_code`, `state`, `zip` | | beneficial\_owner2.home.**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 | | beneficial\_owner2.home.**address2** string Conditionally returned | Additional address information. This field is returned if it exists in the resource. **Allowable Values:** 35 char max | | beneficial\_owner2.home.**city** string Conditionally returned | City of the address. This field is returned if it exists in the resource. **Allowable Values:** 35 char max | | beneficial\_owner2.home.**country** string Conditionally returned | Country of the address. This field is returned if it exists in the resource. **Allowable Values:** 40 char max | | beneficial\_owner2.home.**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 | | beneficial\_owner2.home.**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 | | beneficial\_owner2.home.**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 | | beneficial\_owner2.**identifications** array of objects Conditionally returned | One or more objects containing personal identifications of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** Valid array of one or more `identifications` objects | | beneficial\_owner2.identifications\[].**expiration\_date** string Conditionally returned | Expiration date of the identification, if applicable. **Allowable Values:** Format: yyyy-MM-dd | | beneficial\_owner2.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` | | beneficial\_owner2.identifications\[].**value** string Conditionally returned | Number associated with the identification. **Allowable Values:** 255 char max | | beneficial\_owner2.**last\_name** string Conditionally returned | Last name of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | beneficial\_owner2.**middle\_name** string Conditionally returned | Middle name of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | beneficial\_owner2.**nationality** string Conditionally returned | Nationality of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max ISO 3166 two-character country code | | beneficial\_owner2.**ownership\_percentage** string Conditionally returned | Ownership percentage of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** A number between 1 and 100 | | beneficial\_owner2.**phone** string Conditionally returned | Ten-digit phone number of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** Format: 510-555-1212 or 5105551212 | | beneficial\_owner2.**ssn** string Conditionally returned | Nine-digit Social Security Number (SSN) or Individual Taxpayer Identification Number (ITIN) of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** Nine digits | | beneficial\_owner2.**title** string Conditionally returned | Title of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | beneficial\_owner3 object Conditionally returned | Contains information about the beneficial owner of the business, if applicable. **Allowable Values:** `birth_place`, `dob`, `email`, `first_name`, `home`, `identifications`, `last_name`, `middle_name`, `nationality`, `ownership_percentage`, `phone`, `ssn`, `title` | | beneficial\_owner3.**birth\_place** string Conditionally returned | Country of birth of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max ISO 3166 two-character country code | | beneficial\_owner3.**first\_name** string Conditionally returned | First name of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | beneficial\_owner3.**email** string Conditionally returned | Email address of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | beneficial\_owner3.**dob** datetime Conditionally returned | Date of birth of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** Format: yyyy-MM-dd | | beneficial\_owner3.**home** object Conditionally returned | Address associated with the business. **Allowable Values:** `address1`, `address2`, `city`, `country`, `postal_code`, `state`, `zip` | | beneficial\_owner3.home.**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 | | beneficial\_owner3.home.**address2** string Conditionally returned | Additional address information. This field is returned if it exists in the resource. **Allowable Values:** 35 char max | | beneficial\_owner3.home.**city** string Conditionally returned | City of the address. This field is returned if it exists in the resource. **Allowable Values:** 35 char max | | beneficial\_owner3.home.**country** string Conditionally returned | Country of the address. This field is returned if it exists in the resource. **Allowable Values:** 40 char max | | beneficial\_owner3.home.**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 | | beneficial\_owner3.home.**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 | | beneficial\_owner3.home.**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 | | beneficial\_owner3.**identifications** array of objects Conditionally returned | One or more objects containing personal identifications of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** Valid array of one or more `identifications` objects | | beneficial\_owner3.identifications\[].**expiration\_date** string Conditionally returned | Expiration date of the identification, if applicable. **Allowable Values:** Format: yyyy-MM-dd | | beneficial\_owner3.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` | | beneficial\_owner3.identifications\[].**value** string Conditionally returned | Number associated with the identification. **Allowable Values:** 255 char max | | beneficial\_owner3.**last\_name** string Conditionally returned | Last name of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | beneficial\_owner3.**middle\_name** string Conditionally returned | Middle name of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | beneficial\_owner3.**nationality** string Conditionally returned | Nationality of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max ISO 3166 two-character country code | | beneficial\_owner3.**ownership\_percentage** string Conditionally returned | Ownership percentage of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** A number between 1 and 100 | | beneficial\_owner3.**phone** string Conditionally returned | Ten-digit phone number of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** Format: 510-555-1212 or 5105551212 | | beneficial\_owner3.**ssn** string Conditionally returned | Nine-digit Social Security Number (SSN) or Individual Taxpayer Identification Number (ITIN) of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** Nine digits | | beneficial\_owner3.**title** string Conditionally returned | Title of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | beneficial\_owner4 object Conditionally returned | Contains information about the beneficial owner of the business, if applicable. **Allowable Values:** `birth_place`, `dob`, `email`, `first_name`, `home`, `identifications`, `last_name`, `middle_name`, `nationality`, `ownership_percentage`, `phone`, `ssn`, `title` | | beneficial\_owner4.**birth\_place** string Conditionally returned | Country of birth of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max ISO 3166 two-character country code | | beneficial\_owner4.**first\_name** string Conditionally returned | First name of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | beneficial\_owner4.**email** string Conditionally returned | Email address of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | beneficial\_owner4.**dob** datetime Conditionally returned | Date of birth of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** Format: yyyy-MM-dd | | beneficial\_owner4.**home** object Conditionally returned | Address associated with the business. **Allowable Values:** `address1`, `address2`, `city`, `country`, `postal_code`, `state`, `zip` | | beneficial\_owner4.home.**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 | | beneficial\_owner4.home.**address2** string Conditionally returned | Additional address information. This field is returned if it exists in the resource. **Allowable Values:** 35 char max | | beneficial\_owner4.home.**city** string Conditionally returned | City of the address. This field is returned if it exists in the resource. **Allowable Values:** 35 char max | | beneficial\_owner4.home.**country** string Conditionally returned | Country of the address. This field is returned if it exists in the resource. **Allowable Values:** 40 char max | | beneficial\_owner4.home.**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 | | beneficial\_owner4.home.**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 | | beneficial\_owner4.home.**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 | | beneficial\_owner4.**identifications** array of objects Conditionally returned | One or more objects containing personal identifications of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** Valid array of one or more `identifications` objects | | beneficial\_owner4.identifications\[].**expiration\_date** string Conditionally returned | Expiration date of the identification, if applicable. **Allowable Values:** Format: yyyy-MM-dd | | beneficial\_owner4.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` | | beneficial\_owner4.identifications\[].**value** string Conditionally returned | Number associated with the identification. **Allowable Values:** 255 char max | | beneficial\_owner4.**last\_name** string Conditionally returned | Last name of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | beneficial\_owner4.**middle\_name** string Conditionally returned | Middle name of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | beneficial\_owner4.**nationality** string Conditionally returned | Nationality of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max ISO 3166 two-character country code | | beneficial\_owner4.**ownership\_percentage** string Conditionally returned | Ownership percentage of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** A number between 1 and 100 | | beneficial\_owner4.**phone** string Conditionally returned | Ten-digit phone number of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** Format: 510-555-1212 or 5105551212 | | beneficial\_owner4.**ssn** string Conditionally returned | Nine-digit Social Security Number (SSN) or Individual Taxpayer Identification Number (ITIN) of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** Nine digits | | beneficial\_owner4.**title** string Conditionally returned | Title of the beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | business\_name\_dba string Conditionally returned | Fictitious business name ("Doing Business As" or DBA). This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | business\_name\_legal string Conditionally returned | Legal name of the business. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | business\_type string Conditionally returned | Indicates the type of business, for example B2B (business-to-business) or B2C (business-to-consumer). This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | created\_time datetime Returned | Date and time when the business was created, in UTC. **Allowable Values:** datetime **Format:** yyyy-MM-ddThh:mm:ssZ | | date\_established datetime Conditionally returned | Date and time when the business was established. This field is returned if it exists in the resource. **Allowable Values:** Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ssZ | | duns\_number string Conditionally returned | Data Universal Numbering System (DUNS) number of the business. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | general\_business\_description string Conditionally returned | General description of the business. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | history string Conditionally returned | History of the business. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | identifications array of objects Conditionally returned | One or more objects containing identifications associated with the business. Objects are returned if they exist in the resource. **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 | | in\_current\_location\_since datetime Conditionally returned | Date on which the business office opened in its current location. This field is returned if it exists in the resource. **Allowable Values:** Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ssZ | | incorporation object Conditionally returned | Contains information about the organizational structure of the business. **Allowable Values:** `address_registered_under`, `incorporation_type`, `is_public`, `is_regulated_entity`, `name_registered_under`, `state_of_incorporation`, `stock_symbol` | | incorporation.**address\_registered\_under** object Conditionally returned | Address associated with the business. **Allowable Values:** `address1`, `address2`, `city`, `country`, `postal_code`, `state`, `zip` | | incorporation.address\_registered\_under.**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 | | incorporation.address\_registered\_under.**address2** string Conditionally returned | Additional address information. This field is returned if it exists in the resource. **Allowable Values:** 35 char max | | incorporation.address\_registered\_under.**city** string Conditionally returned | City of the address. This field is returned if it exists in the resource. **Allowable Values:** 35 char max | | incorporation.address\_registered\_under.**country** string Conditionally returned | Country of the address. This field is returned if it exists in the resource. **Allowable Values:** 40 char max | | incorporation.address\_registered\_under.**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 | | incorporation.address\_registered\_under.**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 | | incorporation.address\_registered\_under.**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 | | incorporation.**incorporation\_type** string Conditionally returned | Organizational structure of the business (corporation or sole proprietorship, for example). This field is returned if it exists in the resource. **Allowable Values:** `LLC`, `CORPORATION`, `SOLE_PROPRIETORSHIP`, `PARTNERSHIP`, `OTHER`, `FINANCIAL_OR_CREDIT_INSTITUTION`, `FOUNDATION`, `ASSOCIATION`, `CHARITY`, `TRUST` | | incorporation.**is\_public** boolean Conditionally returned | A value of `true` indicates that the business is publicly held. This field is returned if it exists in the resource. **Allowable Values:** `true`, `false` | | incorporation.**is\_regulated\_entity** boolean Conditionally returned | A value of `true` indicates that the business is a regulated entity. This field is returned if it exists in the resource. **Allowable Values:** `true`, `false` | | incorporation.**name\_registered\_under** string Conditionally returned | Name under which the business is registered. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | incorporation.**state\_of\_incorporation** string Conditionally returned | State, province, territory, or federation where the business is incorporated. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | incorporation.**stock\_symbol** string Conditionally returned | Stock symbol associated with the business. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | international\_office\_locations string Conditionally returned | Locations of the business' offices outside the US. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | ip\_address string Conditionally returned | IP address of the business. This field is returned if it exists in the resource. **Allowable Values:** 39 char max | | last\_modified\_time datetime Returned | Date and time when the business was last modified, in UTC. **Allowable Values:** datetime **Format:** yyyy-MM-ddThh:mm:ssZ | | metadata object Conditionally returned | Associates any additional metadata you provide with the business. Metadata is returned if it exists in the resource. **Allowable Values:** Existing `metadata` object | | notes string Conditionally returned | Any additional information pertaining to the business. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | office\_location object Conditionally returned | Address associated with the business. **Allowable Values:** `address1`, `address2`, `city`, `country`, `postal_code`, `state`, `zip` | | office\_location.**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 | | office\_location.**address2** string Conditionally returned | Additional address information. This field is returned if it exists in the resource. **Allowable Values:** 35 char max | | office\_location.**city** string Conditionally returned | City of the address. This field is returned if it exists in the resource. **Allowable Values:** 35 char max | | office\_location.**country** string Conditionally returned | Country of the address. This field is returned if it exists in the resource. **Allowable Values:** 40 char max | | office\_location.**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 | | office\_location.**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 | | office\_location.**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 | | password string Conditionally returned | Password for the business account on the Marqeta platform. This field is returned if it exists in the resource. **Allowable Values:** 1–255 chars | | phone string Conditionally returned | 10-digit telephone number of the business. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | primary\_contact object Conditionally returned | Describes the business' primary contact person. **Allowable Values:** `department`, `email`, `extension`, `fax`, `full_name`, `mobile`, `phone`, `title` | | primary\_contact.**department** string Conditionally returned | Business department of the primary contact. **Allowable Values:** 255 char max | | primary\_contact.**email** string Conditionally returned | Email address of the primary contact. **Allowable Values:** 255 char max | | primary\_contact.**extension** string Conditionally returned | Phone extension of the primary contact. **Allowable Values:** 255 char max | | primary\_contact.**fax** string Conditionally returned | Fax number of the primary contact. **Allowable Values:** 255 char max Format: 510-555-1212 or 5105551212 | | primary\_contact.**full\_name** string Conditionally returned | Full name of the primary contact. **Allowable Values:** 255 char max | | primary\_contact.**mobile** string Conditionally returned | Mobile phone number of the primary contact. **Allowable Values:** 255 char max Format: 510-555-1212 or 5105551212 | | primary\_contact.**phone** string Conditionally returned | Phone number of the primary contact. **Allowable Values:** 255 char max Format: 510-555-1212 or 5105551212 | | primary\_contact.**title** string Conditionally returned | Title of the primary contact. **Allowable Values:** 255 char max | | proprietor\_is\_beneficial\_owner boolean Conditionally returned | Indicates that the proprietor or officer of the business is also a beneficial owner. This field is returned if it exists in the resource. **Allowable Values:** `true`, `false` | | proprietor\_or\_officer object Conditionally returned | Contains information about the proprietor or officer of the business. **Allowable Values:** `alternative_names`, `birth_place`, `dob`, `email`, `first_name`, `home`, `identifications`, `last_name`, `middle_name`, `nationality`, `phone`, `ssn`, `title` | | proprietor\_or\_officer.**alternative\_names** string Conditionally returned | Alternate names of the business proprietor or officer. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | proprietor\_or\_officer.**birth\_place** string Conditionally returned | Country of birth of the business proprietor or officer. This field is returned if it exists in the resource. **Allowable Values:** 255 char max ISO 3166 two-character country code | | proprietor\_or\_officer.**dob** datetime Conditionally returned | Business proprietor or officer's date of birth. This field is returned if it exists in the resource. **Allowable Values:** Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ssZ | | proprietor\_or\_officer.**email** string Conditionally returned | Email address of the business proprietor or officer. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | proprietor\_or\_officer.**first\_name** string Conditionally returned | First name of the business proprietor or officer. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | proprietor\_or\_officer.**home** object Conditionally returned | Address associated with the business. **Allowable Values:** `address1`, `address2`, `city`, `country`, `postal_code`, `state`, `zip` | | proprietor\_or\_officer.home.**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 | | proprietor\_or\_officer.home.**address2** string Conditionally returned | Additional address information. This field is returned if it exists in the resource. **Allowable Values:** 35 char max | | proprietor\_or\_officer.home.**city** string Conditionally returned | City of the address. This field is returned if it exists in the resource. **Allowable Values:** 35 char max | | proprietor\_or\_officer.home.**country** string Conditionally returned | Country of the address. This field is returned if it exists in the resource. **Allowable Values:** 40 char max | | proprietor\_or\_officer.home.**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 | | proprietor\_or\_officer.home.**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 | | proprietor\_or\_officer.home.**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 | | proprietor\_or\_officer.**identifications** array of objects Conditionally returned | One or more objects containing personal identifications of the business proprietor or officer. This field is returned if it exists in the resource. **Allowable Values:** Valid array of one or more `identifications` objects | | proprietor\_or\_officer.identifications\[].**expiration\_date** string Conditionally returned | Expiration date of the identification, if applicable. **Allowable Values:** Format: yyyy-MM-dd | | proprietor\_or\_officer.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` | | proprietor\_or\_officer.identifications\[].**value** string Conditionally returned | Number associated with the identification. **Allowable Values:** 255 char max | | proprietor\_or\_officer.**last\_name** string Conditionally returned | Last name of the business proprietor or officer. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | proprietor\_or\_officer.**middle\_name** string Conditionally returned | Middle name of the business proprietor or officer. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | proprietor\_or\_officer.**nationality** string Conditionally returned | Nationality of the business proprietor or officer. This field is returned if it exists in the resource. **Allowable Values:** 255 char max ISO 3166 two-character country code | | proprietor\_or\_officer.**phone** string Conditionally returned | Telephone number of the business proprietor or officer. This field is returned if it exists in the resource. **Allowable Values:** Format: 510-555-1212 or 5105551212 | | proprietor\_or\_officer.**ssn** string Conditionally returned | Social Security Number (SSN) or Individual Taxpayer Identification Number (ITIN) of the business proprietor or officer. This field is returned if it exists in the resource. **Allowable Values:** Nine digits | | proprietor\_or\_officer.**title** string Conditionally returned | Title of the business proprietor or officer. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | status string Conditionally returned | Specifies the state of the business on the Marqeta platform. This field is returned if it exists in the resource. **Allowable Values:** `UNVERIFIED`, `LIMITED`, `ACTIVE`, `SUSPENDED`, `CLOSED` | | taxpayer\_id string Conditionally returned | Taxpayer identifier of the business. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | | token string Conditionally returned | Unique identifier of the business resource. This field is always returned. **Allowable Values:** 1–36 chars | | website string Conditionally returned | URL of the business' website. This field is returned if it exists in the resource. **Allowable Values:** 255 char max | ## Sample response body ```json JSON expandable lines wrap theme={null} { "token": "my_business_02", "active": true, "notes": "My notes", "ip_address": "67.120.28.118", "password": "My_passw0rd", "phone": "5105551212", "metadata": { "my_name_1": "my_value_1", "my_name_2": "my_value_2" }, "business_name_legal": "My_legal_business_name", "business_name_dba": "My_fictitious_business_name", "office_location": { "address1": "123 A Street", "address2": "Suite 123", "city": "Oakland", "state": "CA", "postal_code": "94610", "country": "US" }, "in_current_location_since": "2010-04-15T00:01:00Z", "website": "https://my_business_02.com", "date_established": "2010-04-15T00:01:00Z", "general_business_description": "44112 - Used Car Dealers", "history": "My_business_history", "business_type": "My_business_type", "international_office_locations": "Athens, Greece; Buenos Aires, Argentina", "identifications": [ { "type": "BUSINESS_TAX_ID", "value": "123456789" } ], "duns_number": "987654321", "primary_contact": { "full_name": "First Middle Last", "title": "Dr", "department": "My_department", "phone": "5105551212", "extension": "11", "fax": "5105551222", "mobile": "5105551213", "email": "dr.me@my.business.com" }, "incorporation": { "is_public": true, "stock_symbol": "MB", "state_of_incorporation": "CA", "name_registered_under": "First Middle Last", "address_registered_under": { "address1": "123 B Street", "city": "Oakland", "state": "CA", "postal_code": "94610", "country": "US" }, "incorporation_type": "LLC" }, "proprietor_or_officer": { "title": "Mr", "dob": "1985-01-08T00:00:00Z", "phone": "5105551211", "email": "mr.myself@my.business.com", "first_name": "First", "middle_name": "Middle", "last_name": "Last", "alternative_names": "My Alternative Name", "ssn": "5555", "home": { "address1": "123 B Street", "address2": "Apt A", "city": "Oakland", "state": "CA", "postal_code": "94610", "country": "US" } }, "created_time": "2025-01-13T23:29:10Z", "last_modified_time": "2025-01-13T23:29:10Z", "deposit_account": { "x-mq-internal": true, "token": "420df02a-6aef-42bf-be7b-0d080ebf7573", "account_number": "12342126720827265", "routing_number": "293748000" }, "status": "ACTIVE" } ``` ## Related topics - [Create business director](https://www.marqeta.com/docs/core-api/businesses/business-directors/create-director.md) - [Create business transition](https://www.marqeta.com/docs/core-api/business-transitions/create-business-transition.md) - [Businesses Overview](https://www.marqeta.com/docs/core-api/businesses.md) - [Business Transitions Overview](https://www.marqeta.com/docs/core-api/business-transitions.md) - [Business Directors Overview](https://www.marqeta.com/docs/core-api/businesses/business-directors.md)