POST//
To search for one or more businesses, send a POST request to the /businesses/lookup endpoint. Include in the message body any parameters by which you want to query. This endpoint supports field filtering and pagination.
Request body
| Fields | Description |
|---|---|
| dda string Required | Deposit account number of the business. Send a GET request to /directdeposits/accounts/{business_token} to retrieve the deposit account number for a specific business.Send a GET request to /businesses to retrieve business tokens.Allowable Values: 17 char max |
Sample request body
JSON
{
"dda": "2129923205648"
}
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, falseDefault 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. |
| 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 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 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. |
| 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. |
| 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 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 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. |
| 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. |
| 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 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 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. |
| 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. |
| 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 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 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. |
| 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, 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 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 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, falseDefault 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 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 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 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, falseDefault 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. |
| 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 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 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. |
| 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 |
Sample response body
JSON
{
"token": "297aa1a7-f3c9-46eb-9e0a-54f8bce0c189",
"active": true,
"phone": "5105551218",
"metadata": {
"my_name_1": "my_value_1",
"my_name_2": "my_value_2"
},
"account_holder_group_token": "DEFAULT_AHG",
"created_time": "2024-06-20T00:17:48Z",
"last_modified_time": "2024-06-20T00:17:48Z",
"business_name_legal": "My_legal_business_name",
"business_name_dba": "My_fictitious_business_name",
"office_location": {
"address1": "111 Main St",
"address2": "Suite B",
"city": "Berkeley",
"state": "CA",
"postal_code": "94702",
"country": "USA"
},
"date_established": "2010-01-01T00:01:00Z",
"business_type": "other",
"duns_number": "22344566",
"primary_contact": {
"full_name": "First Middle Last",
"title": "Mr.",
"department": "Accounts Payable",
"phone": "5105551218",
"extension": "234",
"fax": "5105551219",
"mobile": "5105551220",
"email": "me@my.company.com"
},
"incorporation": {
"state_of_incorporation": "CA,",
"incorporation_type": "CORPORATION"
},
"identifications": [
{
"type": "BUSINESS_TAX_ID",
"value": "11-1111111"
}
]
}