> ## 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.

# Update business

> To update a business, send a PUT request to /businesses/{token}.

PUT/businesses/\{token}

To update a business, send a `PUT` request to `/businesses/{token}`. Use the `token` path parameter to specify the business to update. Include the business details to update in [JSON](http://www.json.org/) format in the body of the request. Only values of parameters in the request are modified; all others are left unchanged.

## URL path parameters

| Fields | Description |
| - | - |
| token string  Required | Unique identifier of the business resource **Allowable Values:**  Existing business resource token |

## Request body

| Fields | Description |
| - | - |
| account\_holder\_group\_token string  Optional | 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  Existing account holder group token. |
| active boolean  Optional | Specifies if the business is in the `ACTIVE` state on the Marqeta platform. **Allowable Values:**  `true`, `false` |
| 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 business-to-business (B2B) or business-to-consumer (B2C). **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 United States. **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  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:**  255 char max  - 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 in the United States if the business proprietor or officer is also a beneficial owner. If the proprietor or business officer is a beneficial owner, use this field to indicate their beneficial ownership. Do not include information about the proprietor or business officer in a `beneficial_owner` object. **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. Send a `GET` request to `/businesses` to retrieve business tokens. **Allowable Values:**  1–36 chars |
| website string  Optional | URL of the business' website. **Allowable Values:**  255 char max  255 char max |

## Response body

| Fields | Description |
| - | - |
| account\_holder\_group\_token string  Conditionally returned | 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  Conditionally returned | Specifies if the business is in the `ACTIVE` state on the Marqeta platform. **Allowable Values:**  `true`, `false` **Default value:** `true` |
| attestation\_consent boolean  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | Title of the attester for KYC verification. **Allowable Values:**  64 char max |
| beneficial\_owner1 object  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | Beneficial owner's date of birth. **Allowable Values:**  Format: yyyy-MM-dd |
| beneficial\_owner1.**email** string  Conditionally returned | Email address of the beneficial owner. **Allowable Values:**  1–255 chars  255 char max |
| beneficial\_owner1.**first\_name** string  Conditionally returned | 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  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 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  Conditionally returned | Additional address information. **Allowable Values:**  35 char max |
| beneficial\_owner1.home.**city** string  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | United States ZIP code of the address. **Allowable Values:**  20 char max |
| beneficial\_owner1.**identifications** array of objects  Conditionally returned | 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  Conditionally returned | Expiration date of the identification, if applicable. **Allowable Values:**  Format: yyyy-MM-dd |
| beneficial\_owner1.identifications\[].**type** string  Returned | 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  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | Middle name of the beneficial owner. **Allowable Values:**  255 char max |
| beneficial\_owner1.**nationality** string  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | Ten-digit phone number of the beneficial owner. **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. **Allowable Values:**  Digits only, do not use separators. For example: 123456789 |
| beneficial\_owner1.**title** string  Conditionally returned | Title of the beneficial owner. **Allowable Values:**  255 char max |
| beneficial\_owner2 object  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | Beneficial owner's date of birth. **Allowable Values:**  Format: yyyy-MM-dd |
| beneficial\_owner2.**email** string  Conditionally returned | Email address of the beneficial owner. **Allowable Values:**  1–255 chars  255 char max |
| beneficial\_owner2.**first\_name** string  Conditionally returned | 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  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 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  Conditionally returned | Additional address information. **Allowable Values:**  35 char max |
| beneficial\_owner2.home.**city** string  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | United States ZIP code of the address. **Allowable Values:**  20 char max |
| beneficial\_owner2.**identifications** array of objects  Conditionally returned | 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  Conditionally returned | Expiration date of the identification, if applicable. **Allowable Values:**  Format: yyyy-MM-dd |
| beneficial\_owner2.identifications\[].**type** string  Returned | 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  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | Middle name of the beneficial owner. **Allowable Values:**  255 char max |
| beneficial\_owner2.**nationality** string  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | Ten-digit phone number of the beneficial owner. **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. **Allowable Values:**  Digits only, do not use separators. For example: 123456789 |
| beneficial\_owner2.**title** string  Conditionally returned | Title of the beneficial owner. **Allowable Values:**  255 char max |
| beneficial\_owner3 object  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | Beneficial owner's date of birth. **Allowable Values:**  Format: yyyy-MM-dd |
| beneficial\_owner3.**email** string  Conditionally returned | Email address of the beneficial owner. **Allowable Values:**  1–255 chars  255 char max |
| beneficial\_owner3.**first\_name** string  Conditionally returned | 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  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 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  Conditionally returned | Additional address information. **Allowable Values:**  35 char max |
| beneficial\_owner3.home.**city** string  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | United States ZIP code of the address. **Allowable Values:**  20 char max |
| beneficial\_owner3.**identifications** array of objects  Conditionally returned | 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  Conditionally returned | Expiration date of the identification, if applicable. **Allowable Values:**  Format: yyyy-MM-dd |
| beneficial\_owner3.identifications\[].**type** string  Returned | 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  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | Middle name of the beneficial owner. **Allowable Values:**  255 char max |
| beneficial\_owner3.**nationality** string  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | Ten-digit phone number of the beneficial owner. **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. **Allowable Values:**  Digits only, do not use separators. For example: 123456789 |
| beneficial\_owner3.**title** string  Conditionally returned | Title of the beneficial owner. **Allowable Values:**  255 char max |
| beneficial\_owner4 object  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | Beneficial owner's date of birth. **Allowable Values:**  Format: yyyy-MM-dd |
| beneficial\_owner4.**email** string  Conditionally returned | Email address of the beneficial owner. **Allowable Values:**  1–255 chars  255 char max |
| beneficial\_owner4.**first\_name** string  Conditionally returned | 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  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 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  Conditionally returned | Additional address information. **Allowable Values:**  35 char max |
| beneficial\_owner4.home.**city** string  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | United States ZIP code of the address. **Allowable Values:**  20 char max |
| beneficial\_owner4.**identifications** array of objects  Conditionally returned | 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  Conditionally returned | Expiration date of the identification, if applicable. **Allowable Values:**  Format: yyyy-MM-dd |
| beneficial\_owner4.identifications\[].**type** string  Returned | 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  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | Middle name of the beneficial owner. **Allowable Values:**  255 char max |
| beneficial\_owner4.**nationality** string  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | Ten-digit phone number of the beneficial owner. **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. **Allowable Values:**  Digits only, do not use separators. For example: 123456789 |
| beneficial\_owner4.**title** string  Conditionally returned | Title of the beneficial owner. **Allowable Values:**  255 char max |
| business\_name\_dba string  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | Indicates the type of business, for example B2B (business-to-business) or B2C (business-to-consumer). **Allowable Values:**  255 char max |
| date\_established datetime  Conditionally returned | Date when the business was established. **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. **Allowable Values:**  255 char max |
| general\_business\_description string  Conditionally returned | 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  Conditionally returned | History of the business. **Allowable Values:**  255 char max |
| identifications array of objects  Conditionally returned | One or more objects containing identifications associated with the business. **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  Returned | 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  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | 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  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 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  Conditionally returned | Additional address information. **Allowable Values:**  35 char max |
| incorporation.address\_registered\_under.**city** string  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | United States ZIP code of the address. **Allowable Values:**  20 char max |
| incorporation.**incorporation\_type** string  Conditionally returned | 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  Conditionally returned | A value of `true` indicates that the business is publicly held. **Allowable Values:**  `true`, `false` **Default value:** `false` |
| incorporation.**is\_regulated\_entity** boolean  Conditionally returned | A value of `true` indicates that the business is a regulated entity. **Allowable Values:**  `true`, `false` |
| incorporation.**name\_registered\_under** string  Conditionally returned | Name under which the business is registered. **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 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  Conditionally returned | Business stock symbol. **Allowable Values:**  255 char max |
| international\_office\_locations string  Conditionally returned | Locations of the business' offices outside the US. **Allowable Values:**  255 char max |
| ip\_address string  Conditionally returned | IP address of the business. **Allowable Values:**  39 char max |
| metadata object  Conditionally returned | 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  Conditionally returned | Any additional information pertaining to the business. **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 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  Conditionally returned | Additional address information. **Allowable Values:**  35 char max |
| office\_location.**city** string  Conditionally returned | City of the address. This field is required for KYC verification (US-based accounts only). **Allowable Values:**  35 char max |
| office\_location.**country** string  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | United States ZIP code of the address. **Allowable Values:**  20 char max |
| password string  Conditionally returned | 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  Conditionally returned | 10-digit telephone number of business. **Allowable Values:**  255 char max  Format: 510-555-1212 or 5105551212 |
| 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 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  Conditionally returned | 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  Conditionally returned | Alternate names of the business proprietor or officer. **Allowable Values:**  255 char max |
| proprietor\_or\_officer.**birth\_place** string  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | Email address of the business proprietor or officer. **Allowable Values:**  255 char max |
| proprietor\_or\_officer.**first\_name** string  Returned | 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  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 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  Conditionally returned | Additional address information. **Allowable Values:**  35 char max |
| proprietor\_or\_officer.home.**city** string  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | United States ZIP code of the address. **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. **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  Returned | 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  Conditionally returned | 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  Returned | 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  Conditionally returned | Middle name of business proprietor or officer. **Allowable Values:**  255 char max |
| proprietor\_or\_officer.**nationality** string  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | 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  Conditionally returned | Title of business proprietor or officer. **Allowable Values:**  255 char max |
| taxpayer\_id string  Conditionally returned | Taxpayer identifier of the business. **Allowable Values:**  255 char max |
| token string  Conditionally returned | 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  Conditionally returned | URL of the business' website. **Allowable Values:**  255 char max |


## Related topics

- [Update business director](https://www.marqeta.com/docs/core-api/businesses/business-directors/update-director.md)
- [Businesses Overview](https://www.marqeta.com/docs/core-api/businesses.md)
- [Business Directors Overview](https://www.marqeta.com/docs/core-api/businesses/business-directors.md)
- [Release Notes](https://www.marqeta.com/docs/developer-guides/release-notes-2025.md)
- [Card Network Certifications 2025](https://www.marqeta.com/docs/developer-guides/card-network-certifications-2025.md)