GET//
To retrieve a specific business, send a GET request to the /businesses/{token} endpoint. Include the business token path parameter to specify the business to return.
This endpoint supports field filtering and sorting and pagination.
URL path parameters
| Fields | Description |
|---|---|
| token string Required | Unique identifier of the business resource. Allowable Values: Existing business resource token |
URL query parameters
| Fields | Description |
|---|---|
| fields string Optional | Comma-delimited list of fields to return (field_1,field_2, and so on). Leave blank to return all fields.Allowable Values: Comma-delimited list of fields, or blank |
Response body
| Fields | Description |
|---|---|
| account_holder_group_token string Conditionally returned | Associates the specified account holder group with the business. This field is returned if it exists in the resource. Allowable Values: 36 char max |
| active boolean Conditionally returned | Specifies if the business is in the ACTIVE state on the Marqeta platform.This field is returned if it exists in the resource. Allowable Values: true, false |
| attestation_consent boolean Conditionally returned | Indicates that the attester agrees that the information provided is correct and truthful. This field is returned if it exists in the resource. Allowable Values: true, false |
| attestation_date datetime Conditionally returned | Timestamp of the attestation. This field is returned if it exists in the resource. Allowable Values: Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ssZ |
| attester_name string Conditionally returned | Name of the attester for KYC verification. This field is returned if it exists in the resource. Allowable Values: 64 char max |
| attester_title string Conditionally returned | Title of the attester for KYC verification. This field is returned if it exists in the resource. Allowable Values: 64 char max |
| authentication object Conditionally returned | Contains metadata about the business’s email verification and password updates. Allowable Values: email_verified, email_verified_time, last_password_update_channel, last_password_update_time |
| authentication.email_verified boolean Conditionally returned | Specifies whether the email address has been verified. Allowable Values: true, false |
| authentication.email_verified_time datetime Conditionally returned | Date and time when the email address was verified. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ |
| authentication.last_password_update_channel string Conditionally returned | Specifies the channel through which the password was last changed. Allowable Values: USER_CHANGE, USER_RESET |
| authentication.last_password_update_time datetime Conditionally returned | Date and time when the password was last changed. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ |
| beneficial_owner1 object Conditionally returned | Contains information about the beneficial owner of the business, if applicable. Allowable Values: birth_place, dob, email, first_name, home, identifications, last_name, middle_name, nationality, ownership_percentage, phone, ssn, title |
| beneficial_owner1.birth_place string Conditionally returned | Country of birth of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max ISO 3166 two-character country code |
| beneficial_owner1.first_name string Conditionally returned | First name of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| beneficial_owner1.email string Conditionally returned | Email address of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| beneficial_owner1.dob datetime Conditionally returned | Date of birth of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: Format: yyyy-MM-dd |
| beneficial_owner1.home object Conditionally returned | Address associated with the business. Allowable Values: address1, address2, city, country, postal_code, state, zip |
| beneficial_owner1.home.address1 string Conditionally returned | Street name and number of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| beneficial_owner1.home.address2 string Conditionally returned | Additional address information. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| beneficial_owner1.home.city string Conditionally returned | City of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| beneficial_owner1.home.country string Conditionally returned | Country of the address. This field is returned if it exists in the resource. Allowable Values: 40 char max |
| beneficial_owner1.home.postal_code string Conditionally returned | Postal code of the address. This field is returned if it exists in the resource. Allowable Values: 20 char max |
| beneficial_owner1.home.state string Conditionally returned | State, province, or territory of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| beneficial_owner1.home.zip string Conditionally returned | United States ZIP code of the address. This field is returned if it exists in the resource. Allowable Values: 20 char max |
| beneficial_owner1.identifications array of objects Conditionally returned | One or more objects containing personal identifications of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: Valid array of one or more identifications objects |
| beneficial_owner1.identifications[].expiration_date string Conditionally returned | Expiration date of the identification, if applicable. Allowable Values: Format: yyyy-MM-dd |
| beneficial_owner1.identifications[].type string Conditionally returned | Type of identification. Allowable Values: SSN, TIN, SIN, NIN, PASSPORT_NUMBER, DRIVERS_LICENSE, BUSINESS_NUMBER, BUSINESS_TAX_ID, TAXPAYER_REFERENCE |
| beneficial_owner1.identifications[].value string Conditionally returned | Number associated with the identification. Allowable Values: 255 char max |
| beneficial_owner1.last_name string Conditionally returned | Last name of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| beneficial_owner1.middle_name string Conditionally returned | Middle name of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| beneficial_owner1.nationality string Conditionally returned | Nationality of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max ISO 3166 two-character country code |
| beneficial_owner1.ownership_percentage string Conditionally returned | Ownership percentage of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: A number between 1 and 100 |
| beneficial_owner1.phone string Conditionally returned | Ten-digit phone number of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: Format: 510-555-1212 or 5105551212 |
| beneficial_owner1.ssn string Conditionally returned | Nine-digit Social Security Number (SSN) or Individual Taxpayer Identification Number (ITIN) of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: Nine digits |
| beneficial_owner1.title string Conditionally returned | Title of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| beneficial_owner2 object Conditionally returned | Contains information about the beneficial owner of the business, if applicable. Allowable Values: birth_place, dob, email, first_name, home, identifications, last_name, middle_name, nationality, ownership_percentage, phone, ssn, title |
| beneficial_owner2.birth_place string Conditionally returned | Country of birth of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max ISO 3166 two-character country code |
| beneficial_owner2.first_name string Conditionally returned | First name of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| beneficial_owner2.email string Conditionally returned | Email address of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| beneficial_owner2.dob datetime Conditionally returned | Date of birth of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: Format: yyyy-MM-dd |
| beneficial_owner2.home object Conditionally returned | Address associated with the business. Allowable Values: address1, address2, city, country, postal_code, state, zip |
| beneficial_owner2.home.address1 string Conditionally returned | Street name and number of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| beneficial_owner2.home.address2 string Conditionally returned | Additional address information. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| beneficial_owner2.home.city string Conditionally returned | City of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| beneficial_owner2.home.country string Conditionally returned | Country of the address. This field is returned if it exists in the resource. Allowable Values: 40 char max |
| beneficial_owner2.home.postal_code string Conditionally returned | Postal code of the address. This field is returned if it exists in the resource. Allowable Values: 20 char max |
| beneficial_owner2.home.state string Conditionally returned | State, province, or territory of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| beneficial_owner2.home.zip string Conditionally returned | United States ZIP code of the address. This field is returned if it exists in the resource. Allowable Values: 20 char max |
| beneficial_owner2.identifications array of objects Conditionally returned | One or more objects containing personal identifications of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: Valid array of one or more identifications objects |
| beneficial_owner2.identifications[].expiration_date string Conditionally returned | Expiration date of the identification, if applicable. Allowable Values: Format: yyyy-MM-dd |
| beneficial_owner2.identifications[].type string Conditionally returned | Type of identification. Allowable Values: SSN, TIN, SIN, NIN, PASSPORT_NUMBER, DRIVERS_LICENSE, BUSINESS_NUMBER, BUSINESS_TAX_ID, TAXPAYER_REFERENCE |
| beneficial_owner2.identifications[].value string Conditionally returned | Number associated with the identification. Allowable Values: 255 char max |
| beneficial_owner2.last_name string Conditionally returned | Last name of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| beneficial_owner2.middle_name string Conditionally returned | Middle name of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| beneficial_owner2.nationality string Conditionally returned | Nationality of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max ISO 3166 two-character country code |
| beneficial_owner2.ownership_percentage string Conditionally returned | Ownership percentage of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: A number between 1 and 100 |
| beneficial_owner2.phone string Conditionally returned | Ten-digit phone number of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: Format: 510-555-1212 or 5105551212 |
| beneficial_owner2.ssn string Conditionally returned | Nine-digit Social Security Number (SSN) or Individual Taxpayer Identification Number (ITIN) of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: Nine digits |
| beneficial_owner2.title string Conditionally returned | Title of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| beneficial_owner3 object Conditionally returned | Contains information about the beneficial owner of the business, if applicable. Allowable Values: birth_place, dob, email, first_name, home, identifications, last_name, middle_name, nationality, ownership_percentage, phone, ssn, title |
| beneficial_owner3.birth_place string Conditionally returned | Country of birth of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max ISO 3166 two-character country code |
| beneficial_owner3.first_name string Conditionally returned | First name of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| beneficial_owner3.email string Conditionally returned | Email address of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| beneficial_owner3.dob datetime Conditionally returned | Date of birth of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: Format: yyyy-MM-dd |
| beneficial_owner3.home object Conditionally returned | Address associated with the business. Allowable Values: address1, address2, city, country, postal_code, state, zip |
| beneficial_owner3.home.address1 string Conditionally returned | Street name and number of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| beneficial_owner3.home.address2 string Conditionally returned | Additional address information. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| beneficial_owner3.home.city string Conditionally returned | City of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| beneficial_owner3.home.country string Conditionally returned | Country of the address. This field is returned if it exists in the resource. Allowable Values: 40 char max |
| beneficial_owner3.home.postal_code string Conditionally returned | Postal code of the address. This field is returned if it exists in the resource. Allowable Values: 20 char max |
| beneficial_owner3.home.state string Conditionally returned | State, province, or territory of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| beneficial_owner3.home.zip string Conditionally returned | United States ZIP code of the address. This field is returned if it exists in the resource. Allowable Values: 20 char max |
| beneficial_owner3.identifications array of objects Conditionally returned | One or more objects containing personal identifications of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: Valid array of one or more identifications objects |
| beneficial_owner3.identifications[].expiration_date string Conditionally returned | Expiration date of the identification, if applicable. Allowable Values: Format: yyyy-MM-dd |
| beneficial_owner3.identifications[].type string Conditionally returned | Type of identification. Allowable Values: SSN, TIN, SIN, NIN, PASSPORT_NUMBER, DRIVERS_LICENSE, BUSINESS_NUMBER, BUSINESS_TAX_ID, TAXPAYER_REFERENCE |
| beneficial_owner3.identifications[].value string Conditionally returned | Number associated with the identification. Allowable Values: 255 char max |
| beneficial_owner3.last_name string Conditionally returned | Last name of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| beneficial_owner3.middle_name string Conditionally returned | Middle name of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| beneficial_owner3.nationality string Conditionally returned | Nationality of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max ISO 3166 two-character country code |
| beneficial_owner3.ownership_percentage string Conditionally returned | Ownership percentage of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: A number between 1 and 100 |
| beneficial_owner3.phone string Conditionally returned | Ten-digit phone number of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: Format: 510-555-1212 or 5105551212 |
| beneficial_owner3.ssn string Conditionally returned | Nine-digit Social Security Number (SSN) or Individual Taxpayer Identification Number (ITIN) of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: Nine digits |
| beneficial_owner3.title string Conditionally returned | Title of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| beneficial_owner4 object Conditionally returned | Contains information about the beneficial owner of the business, if applicable. Allowable Values: birth_place, dob, email, first_name, home, identifications, last_name, middle_name, nationality, ownership_percentage, phone, ssn, title |
| beneficial_owner4.birth_place string Conditionally returned | Country of birth of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max ISO 3166 two-character country code |
| beneficial_owner4.first_name string Conditionally returned | First name of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| beneficial_owner4.email string Conditionally returned | Email address of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| beneficial_owner4.dob datetime Conditionally returned | Date of birth of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: Format: yyyy-MM-dd |
| beneficial_owner4.home object Conditionally returned | Address associated with the business. Allowable Values: address1, address2, city, country, postal_code, state, zip |
| beneficial_owner4.home.address1 string Conditionally returned | Street name and number of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| beneficial_owner4.home.address2 string Conditionally returned | Additional address information. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| beneficial_owner4.home.city string Conditionally returned | City of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| beneficial_owner4.home.country string Conditionally returned | Country of the address. This field is returned if it exists in the resource. Allowable Values: 40 char max |
| beneficial_owner4.home.postal_code string Conditionally returned | Postal code of the address. This field is returned if it exists in the resource. Allowable Values: 20 char max |
| beneficial_owner4.home.state string Conditionally returned | State, province, or territory of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| beneficial_owner4.home.zip string Conditionally returned | United States ZIP code of the address. This field is returned if it exists in the resource. Allowable Values: 20 char max |
| beneficial_owner4.identifications array of objects Conditionally returned | One or more objects containing personal identifications of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: Valid array of one or more identifications objects |
| beneficial_owner4.identifications[].expiration_date string Conditionally returned | Expiration date of the identification, if applicable. Allowable Values: Format: yyyy-MM-dd |
| beneficial_owner4.identifications[].type string Conditionally returned | Type of identification. Allowable Values: SSN, TIN, SIN, NIN, PASSPORT_NUMBER, DRIVERS_LICENSE, BUSINESS_NUMBER, BUSINESS_TAX_ID, TAXPAYER_REFERENCE |
| beneficial_owner4.identifications[].value string Conditionally returned | Number associated with the identification. Allowable Values: 255 char max |
| beneficial_owner4.last_name string Conditionally returned | Last name of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| beneficial_owner4.middle_name string Conditionally returned | Middle name of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| beneficial_owner4.nationality string Conditionally returned | Nationality of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max ISO 3166 two-character country code |
| beneficial_owner4.ownership_percentage string Conditionally returned | Ownership percentage of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: A number between 1 and 100 |
| beneficial_owner4.phone string Conditionally returned | Ten-digit phone number of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: Format: 510-555-1212 or 5105551212 |
| beneficial_owner4.ssn string Conditionally returned | Nine-digit Social Security Number (SSN) or Individual Taxpayer Identification Number (ITIN) of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: Nine digits |
| beneficial_owner4.title string Conditionally returned | Title of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| business_name_dba string Conditionally returned | Fictitious business name (“Doing Business As” or DBA). This field is returned if it exists in the resource. Allowable Values: 255 char max |
| business_name_legal string Conditionally returned | Legal name of the business. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| business_type string Conditionally returned | Indicates the type of business, for example B2B (business-to-business) or B2C (business-to-consumer). This field is returned if it exists in the resource. Allowable Values: 255 char max |
| created_time datetime Returned | Date and time when the business was created, in UTC. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ |
| date_established datetime Conditionally returned | Date and time when the business was established. This field is returned if it exists in the resource. Allowable Values: Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ssZ |
| duns_number string Conditionally returned | Data Universal Numbering System (DUNS) number of the business. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| general_business_description string Conditionally returned | General description of the business. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| history string Conditionally returned | History of the business. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| identifications array of objects Conditionally returned | One or more objects containing identifications associated with the business. Objects are returned if they exist in the resource. Allowable Values: Valid array of one or more identifications objects |
| identifications[].expiration_date string Conditionally returned | Expiration date of the identification, if applicable. Allowable Values: Format: yyyy-MM-dd |
| identifications[].type string Conditionally returned | Type of identification. Allowable Values: SSN, TIN, SIN, NIN, PASSPORT_NUMBER, DRIVERS_LICENSE, BUSINESS_NUMBER, BUSINESS_TAX_ID, TAXPAYER_REFERENCE |
| identifications[].value string Conditionally returned | Number associated with the identification. Allowable Values: 255 char max |
| in_current_location_since datetime Conditionally returned | Date on which the business office opened in its current location. This field is returned if it exists in the resource. Allowable Values: Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ssZ |
| incorporation object Conditionally returned | Contains information about the organizational structure of the business. Allowable Values: address_registered_under, incorporation_type, is_public, is_regulated_entity, name_registered_under, state_of_incorporation, stock_symbol |
| incorporation.address_registered_under object Conditionally returned | Address associated with the business. Allowable Values: address1, address2, city, country, postal_code, state, zip |
| incorporation.address_registered_under.address1 string Conditionally returned | Street name and number of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| incorporation.address_registered_under.address2 string Conditionally returned | Additional address information. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| incorporation.address_registered_under.city string Conditionally returned | City of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| incorporation.address_registered_under.country string Conditionally returned | Country of the address. This field is returned if it exists in the resource. Allowable Values: 40 char max |
| incorporation.address_registered_under.postal_code string Conditionally returned | Postal code of the address. This field is returned if it exists in the resource. Allowable Values: 20 char max |
| incorporation.address_registered_under.state string Conditionally returned | State, province, or territory of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| incorporation.address_registered_under.zip string Conditionally returned | United States ZIP code of the address. This field is returned if it exists in the resource. Allowable Values: 20 char max |
| incorporation.incorporation_type string Conditionally returned | Organizational structure of the business (corporation or sole proprietorship, for example). This field is returned if it exists in the resource. Allowable Values: LLC, CORPORATION, SOLE_PROPRIETORSHIP, PARTNERSHIP, OTHER, FINANCIAL_OR_CREDIT_INSTITUTION, FOUNDATION, ASSOCIATION, CHARITY, TRUST |
| incorporation.is_public boolean Conditionally returned | A value of true indicates that the business is publicly held.This field is returned if it exists in the resource. Allowable Values: true, false |
| incorporation.is_regulated_entity boolean Conditionally returned | A value of true indicates that the business is a regulated entity.This field is returned if it exists in the resource. Allowable Values: true, false |
| incorporation.name_registered_under string Conditionally returned | Name under which the business is registered. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| incorporation.state_of_incorporation string Conditionally returned | State, province, territory, or federation where the business is incorporated. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| incorporation.stock_symbol string Conditionally returned | Stock symbol associated with the business. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| international_office_locations string Conditionally returned | Locations of the business’ offices outside the US. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| ip_address string Conditionally returned | IP address of the business. This field is returned if it exists in the resource. Allowable Values: 39 char max |
| last_modified_time datetime Returned | Date and time when the business was last modified, in UTC. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ |
| metadata object Conditionally returned | Associates any additional metadata you provide with the business. Metadata is returned if it exists in the resource. Allowable Values: Existing metadata object |
| notes string Conditionally returned | Any additional information pertaining to the business. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| office_location object Conditionally returned | Address associated with the business. Allowable Values: address1, address2, city, country, postal_code, state, zip |
| office_location.address1 string Conditionally returned | Street name and number of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| office_location.address2 string Conditionally returned | Additional address information. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| office_location.city string Conditionally returned | City of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| office_location.country string Conditionally returned | Country of the address. This field is returned if it exists in the resource. Allowable Values: 40 char max |
| office_location.postal_code string Conditionally returned | Postal code of the address. This field is returned if it exists in the resource. Allowable Values: 20 char max |
| office_location.state string Conditionally returned | State, province, or territory of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| office_location.zip string Conditionally returned | United States ZIP code of the address. This field is returned if it exists in the resource. Allowable Values: 20 char max |
| password string Conditionally returned | Password for the business account on the Marqeta platform. This field is returned if it exists in the resource. Allowable Values: 1–255 chars |
| phone string Conditionally returned | 10-digit telephone number of the business. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| primary_contact object Conditionally returned | Describes the business’ primary contact person. Allowable Values: department, email, extension, fax, full_name, mobile, phone, title |
| primary_contact.department string Conditionally returned | Business department of the primary contact. Allowable Values: 255 char max |
| primary_contact.email string Conditionally returned | Email address of the primary contact. Allowable Values: 255 char max |
| primary_contact.extension string Conditionally returned | Phone extension of the primary contact. Allowable Values: 255 char max |
| primary_contact.fax string Conditionally returned | Fax number of the primary contact. Allowable Values: 255 char max Format: 510-555-1212 or 5105551212 |
| primary_contact.full_name string Conditionally returned | Full name of the primary contact. Allowable Values: 255 char max |
| primary_contact.mobile string Conditionally returned | Mobile phone number of the primary contact. Allowable Values: 255 char max Format: 510-555-1212 or 5105551212 |
| primary_contact.phone string Conditionally returned | Phone number of the primary contact. Allowable Values: 255 char max Format: 510-555-1212 or 5105551212 |
| primary_contact.title string Conditionally returned | Title of the primary contact. Allowable Values: 255 char max |
| proprietor_is_beneficial_owner boolean Conditionally returned | Indicates that the proprietor or officer of the business is also a beneficial owner. This field is returned if it exists in the resource. Allowable Values: true, false |
| proprietor_or_officer object Conditionally returned | Contains information about the proprietor or officer of the business. Allowable Values: alternative_names, birth_place, dob, email, first_name, home, identifications, last_name, middle_name, nationality, phone, ssn, title |
| proprietor_or_officer.alternative_names string Conditionally returned | Alternate names of the business proprietor or officer. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| proprietor_or_officer.birth_place string Conditionally returned | Country of birth of the business proprietor or officer. This field is returned if it exists in the resource. Allowable Values: 255 char max ISO 3166 two-character country code |
| proprietor_or_officer.dob datetime Conditionally returned | Business proprietor or officer’s date of birth. This field is returned if it exists in the resource. Allowable Values: Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ssZ |
| proprietor_or_officer.email string Conditionally returned | Email address of the business proprietor or officer. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| proprietor_or_officer.first_name string Conditionally returned | First name of the business proprietor or officer. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| proprietor_or_officer.home object Conditionally returned | Address associated with the business. Allowable Values: address1, address2, city, country, postal_code, state, zip |
| proprietor_or_officer.home.address1 string Conditionally returned | Street name and number of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| proprietor_or_officer.home.address2 string Conditionally returned | Additional address information. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| proprietor_or_officer.home.city string Conditionally returned | City of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| proprietor_or_officer.home.country string Conditionally returned | Country of the address. This field is returned if it exists in the resource. Allowable Values: 40 char max |
| proprietor_or_officer.home.postal_code string Conditionally returned | Postal code of the address. This field is returned if it exists in the resource. Allowable Values: 20 char max |
| proprietor_or_officer.home.state string Conditionally returned | State, province, or territory of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
| proprietor_or_officer.home.zip string Conditionally returned | United States ZIP code of the address. This field is returned if it exists in the resource. Allowable Values: 20 char max |
| proprietor_or_officer.identifications array of objects Conditionally returned | One or more objects containing personal identifications of the business proprietor or officer. This field is returned if it exists in the resource. Allowable Values: Valid array of one or more identifications objects |
| proprietor_or_officer.identifications[].expiration_date string Conditionally returned | Expiration date of the identification, if applicable. Allowable Values: Format: yyyy-MM-dd |
| proprietor_or_officer.identifications[].type string Conditionally returned | Type of identification. Allowable Values: SSN, TIN, SIN, NIN, PASSPORT_NUMBER, DRIVERS_LICENSE, BUSINESS_NUMBER, BUSINESS_TAX_ID, TAXPAYER_REFERENCE |
| proprietor_or_officer.identifications[].value string Conditionally returned | Number associated with the identification. Allowable Values: 255 char max |
| proprietor_or_officer.last_name string Conditionally returned | Last name of the business proprietor or officer. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| proprietor_or_officer.middle_name string Conditionally returned | Middle name of the business proprietor or officer. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| proprietor_or_officer.nationality string Conditionally returned | Nationality of the business proprietor or officer. This field is returned if it exists in the resource. Allowable Values: 255 char max ISO 3166 two-character country code |
| proprietor_or_officer.phone string Conditionally returned | Telephone number of the business proprietor or officer. This field is returned if it exists in the resource. Allowable Values: Format: 510-555-1212 or 5105551212 |
| proprietor_or_officer.ssn string Conditionally returned | Social Security Number (SSN) or Individual Taxpayer Identification Number (ITIN) of the business proprietor or officer. This field is returned if it exists in the resource. Allowable Values: Nine digits |
| proprietor_or_officer.title string Conditionally returned | Title of the business proprietor or officer. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| status string Conditionally returned | Specifies the state of the business on the Marqeta platform. This field is returned if it exists in the resource. Allowable Values: UNVERIFIED, LIMITED, ACTIVE, SUSPENDED, CLOSED |
| taxpayer_id string Conditionally returned | Taxpayer identifier of the business. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| token string Conditionally returned | Unique identifier of the business resource. This field is always returned. Allowable Values: 1–36 chars |
| website string Conditionally returned | URL of the business’ website. This field is returned if it exists in the resource. Allowable Values: 255 char max |
Sample response body
JSON
{
"token": "my_business_02",
"active": true,
"notes": "My notes",
"ip_address": "67.120.28.118",
"password": "My_passw0rd",
"phone": "5105551212",
"metadata": {
"my_name_1": "my_value_1",
"my_name_2": "my_value_2"
},
"business_name_legal": "My_legal_business_name",
"business_name_dba": "My_fictitious_business_name",
"office_location": {
"address1": "123 A street",
"address2": "Suite 123",
"city": "Oakland",
"state": "CA",
"postal_code": "94610",
"country": "US"
},
"in_current_location_since": "2010-04-15T00:01:00Z",
"website": "https://my_business_02.com",
"date_established": "2010-04-15T00:01:00Z",
"general_business_description": "44112 - Used Car Dealers",
"history": "My_business_history",
"business_type": "My_business_type",
"international_office_locations": "Athens, Greece; Buenos Aires, Argentina",
"identifications": [
{
"type": "BUSINESS_TAX_ID",
"value": "123456789"
}
],
"duns_number": "123456789",
"primary_contact": {
"full_name": "First Middle Last",
"title": "Dr",
"department": "My_department",
"phone": "5105551212",
"extension": "11",
"fax": "5105551222",
"mobile": "5105551213",
"email": "dr.me@my.business.com"
},
"incorporation": {
"is_public": true,
"stock_symbol": "MB",
"state_of_incorporation": "CA",
"name_registered_under": "First Middle Last",
"address_registered_under": {
"address1": "123 B Street",
"city": "Oakland",
"state": "CA",
"postal_code": "94610",
"country": "US"
},
"incorporation_type": "LLC"
},
"proprietor_or_officer": {
"title": "Mr",
"dob": "1985-01-08T00:00:00Z",
"phone": "5105551211",
"email": "mr.myself@my.business.com",
"first_name": "First",
"middle_name": "Middle",
"last_name": "Last",
"alternative_names": "My Alternative Name",
"ssn": "5555",
"home": {
"address1": "123 B Street",
"address2": "Apt A",
"city": "Oakland",
"state": "CA",
"postal_code": "94610",
"country": "US"
}
},
"created_time": "2025-01-13T23:29:10Z",
"last_modified_time": "2025-01-13T23:29:10Z",
"deposit_account": {
"x-mq-internal": true,
"token": "420df02a-6aef-42bf-be7b-0d080ebf7573",
"account_number": "12342126720827265",
"routing_number": "293748000"
},
"status": "ACTIVE"
}