Businesses
A business is a type of account holder that cannot directly hold cards, but can have parent/child relationships with card-holding users. A business can monitor and control card use by a specified group of users. Every business has a general purpose account (GPA).
For information on how to create a user that has a child-to-parent hierarchical relationship to the business, see Create User.
Note
A user can simultaneously be a child of a business and a parent of other users if the user is not configured to use the parent’s account balances and the user’s children are configured to use the parent’s account balances. For more information on account holders, see About Account Holders.
Create business
Copy section link
Action: POST
Endpoint: /businesses
Create a business. The initial status of a newly created business depends on the Know Your Customer (KYC) requirements of the program or associated account holder group.
KYC Required | Initial Business State | Business Active on Creation | Business Limitations |
---|---|---|---|
Always |
|
No |
Cannot load funds. |
Conditionally |
|
No |
Restricted by rules in |
Never |
|
Required |
None. |
To change or track the history of a business' status, use the /businesstransitions
endpoint.
For more information on status changes, see Create Business Transition.
For information about configuring the required fields for KYC verification, see Perform KYC.
Request body
Copy section link
Fields | Description |
---|---|
account_holder_group_token
string
|
Existing account holder group token that associates the specified account holder group with the business.
Send a Allowable Values: 36 char max |
active
boolean
|
Specifies if the business is in the Allowable Values:
Default value: |
attestation_consent
boolean
|
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:
|
attestation_date
datetime
|
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
|
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
|
Title of the attester for KYC verification. Allowable Values: 64 char max |
beneficial_owner1
object
|
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 has a beneficial owner.
Do not include information about the proprietor or business officer in a Allowable Values:
|
beneficial_owner1.dob
datetime
|
Date of birth of the beneficial owner. Allowable Values: Format: yyyy-MM-dd |
beneficial_owner1.first_name
string
|
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
|
Address associated with the business. Allowable Values:
|
beneficial_owner1.home.address1
string
|
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
|
Additional address information. Allowable Values: 35 char max |
beneficial_owner1.home.city
string
|
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
|
Country of the address. Allowable Values: 40 char max ISO alpha-2 country code required for KYC verification ( |
beneficial_owner1.home.postal_code
string
|
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
|
State of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max Valid two-letter abbreviation required for KYC verification ( |
beneficial_owner1.home.zip
string
|
United States ZIP code of the address. Allowable Values: 20 char max |
beneficial_owner1.last_name
string
|
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
|
Middle name of the beneficial owner. Allowable Values: 255 char max |
beneficial_owner1.phone
string
|
Ten-digit phone number of the beneficial owner. Allowable Values: Format: 510-555-1212 or 5105551212 |
beneficial_owner1.ssn
string
|
Nine-digit Social Security Number (SSN) of the beneficial owner. Allowable Values: Digits only, do not use separators. For example: 123456789 |
beneficial_owner1.title
string
|
Title of the beneficial owner. Allowable Values: 255 char max |
beneficial_owner2
object
|
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 has a beneficial owner.
Do not include information about the proprietor or business officer in a Allowable Values:
|
beneficial_owner2.dob
datetime
|
Date of birth of the beneficial owner. Allowable Values: Format: yyyy-MM-dd |
beneficial_owner2.first_name
string
|
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
|
Address associated with the business. Allowable Values:
|
beneficial_owner2.home.address1
string
|
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
|
Additional address information. Allowable Values: 35 char max |
beneficial_owner2.home.city
string
|
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
|
Country of the address. Allowable Values: 40 char max ISO alpha-2 country code required for KYC verification ( |
beneficial_owner2.home.postal_code
string
|
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
|
State of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max Valid two-letter abbreviation required for KYC verification ( |
beneficial_owner2.home.zip
string
|
United States ZIP code of the address. Allowable Values: 20 char max |
beneficial_owner2.last_name
string
|
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
|
Middle name of the beneficial owner. Allowable Values: 255 char max |
beneficial_owner2.phone
string
|
Ten-digit phone number of the beneficial owner. Allowable Values: Format: 510-555-1212 or 5105551212 |
beneficial_owner2.ssn
string
|
Nine-digit Social Security Number (SSN) of the beneficial owner. Allowable Values: Digits only, do not use separators. For example: 123456789 |
beneficial_owner2.title
string
|
Title of the beneficial owner. Allowable Values: 255 char max |
beneficial_owner3
object
|
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 has a beneficial owner.
Do not include information about the proprietor or business officer in a Allowable Values:
|
beneficial_owner3.dob
datetime
|
Date of birth of the beneficial owner. Allowable Values: Format: yyyy-MM-dd |
beneficial_owner3.first_name
string
|
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
|
Address associated with the business. Allowable Values:
|
beneficial_owner3.home.address1
string
|
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
|
Additional address information. Allowable Values: 35 char max |
beneficial_owner3.home.city
string
|
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
|
Country of the address. Allowable Values: 40 char max ISO alpha-2 country code required for KYC verification ( |
beneficial_owner3.home.postal_code
string
|
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
|
State of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max Valid two-letter abbreviation required for KYC verification ( |
beneficial_owner3.home.zip
string
|
United States ZIP code of the address. Allowable Values: 20 char max |
beneficial_owner3.last_name
string
|
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
|
Middle name of the beneficial owner. Allowable Values: 255 char max |
beneficial_owner3.phone
string
|
Ten-digit phone number of the beneficial owner. Allowable Values: Format: 510-555-1212 or 5105551212 |
beneficial_owner3.ssn
string
|
Nine-digit Social Security Number (SSN) of the beneficial owner. Allowable Values: Digits only, do not use separators. For example: 123456789 |
beneficial_owner3.title
string
|
Title of the beneficial owner. Allowable Values: 255 char max |
beneficial_owner4
object
|
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 has a beneficial owner.
Do not include information about the proprietor or business officer in a Allowable Values:
|
beneficial_owner4.dob
datetime
|
Date of birth of the beneficial owner. Allowable Values: Format: yyyy-MM-dd |
beneficial_owner4.first_name
string
|
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
|
Address associated with the business. Allowable Values:
|
beneficial_owner4.home.address1
string
|
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
|
Additional address information. Allowable Values: 35 char max |
beneficial_owner4.home.city
string
|
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
|
Country of the address. Allowable Values: 40 char max ISO alpha-2 country code required for KYC verification ( |
beneficial_owner4.home.postal_code
string
|
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
|
State of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max Valid two-letter abbreviation required for KYC verification ( |
beneficial_owner4.home.zip
string
|
United States ZIP code of the address. Allowable Values: 20 char max |
beneficial_owner4.last_name
string
|
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
|
Middle name of the beneficial owner. Allowable Values: 255 char max |
beneficial_owner4.phone
string
|
Ten-digit phone number of the beneficial owner. Allowable Values: Format: 510-555-1212 or 5105551212 |
beneficial_owner4.ssn
string
|
Nine-digit Social Security Number (SSN) of the beneficial owner. Allowable Values: Digits only, do not use separators. For example: 123456789 |
beneficial_owner4.title
string
|
Title of the beneficial owner. Allowable Values: 255 char max |
business_name_dba
string
|
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
|
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
|
Indicates the type of business, for example B2B (business-to-business) or B2C (business-to-consumer). Allowable Values: 255 char max |
date_established
datetime
|
Date the business was established. This field is required for KYC verification (US-based accounts only). Allowable Values: Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ssZ |
duns_number
string
|
Data Universal Numbering System (DUNS) number of the business. Allowable Values: 255 char max |
general_business_description
string
|
General description of the business. Allowable Values: 255 char max |
history
string
|
History of the business. Allowable Values: 255 char max |
identifications
array of objects
|
One or more objects containing identifications associated with the business. Allowable Values: Valid array of one or more |
identifications[].expiration_date
string
|
Expiration date of the identification, if applicable. Allowable Values: Format: yyyy-MM-dd |
identifications[].type
string
|
Type of identification. NOTE: Full Social Security Number (SSN) is required for US-based cardholder KYC verification.
Nine digits only, no delimiters.
Allowable Values:
|
identifications[].value
string
|
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
|
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
|
Contains information about the organizational structure of the business. This object is required for KYC verification (US-based accounts only). Allowable Values:
|
incorporation.address_registered_under
object
|
Address associated with the business. Allowable Values:
|
incorporation.address_registered_under.address1
string
|
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
|
Additional address information. Allowable Values: 35 char max |
incorporation.address_registered_under.city
string
|
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
|
Country of the address. Allowable Values: 40 char max ISO alpha-2 country code required for KYC verification ( |
incorporation.address_registered_under.postal_code
string
|
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
|
State of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max Valid two-letter abbreviation required for KYC verification ( |
incorporation.address_registered_under.zip
string
|
United States ZIP code of the address. Allowable Values: 20 char max |
incorporation.incorporation_type
string
|
Organizational structure of the business, such as corporation or sole proprietorship. This field is required for KYC verification (US-based accounts only). Allowable Values:
|
incorporation.is_public
boolean
|
A value of Allowable Values:
Default value: |
incorporation.name_registered_under
string
|
Name under which the business is registered. Allowable Values: 255 char max |
incorporation.state_of_incorporation
string
|
State where the business is incorporated. This field is required for KYC verification (US-based accounts only). Allowable Values: 255 char max Valid two-letter state, provincial, or territorial abbreviation required for KYC verification ( |
incorporation.stock_symbol
string
|
Business stock symbol. Allowable Values: 255 char max |
international_office_locations
string
|
Locations of the business' offices outside the US. Allowable Values: 255 char max |
ip_address
string
|
IP address of the business. Allowable Values: 39 char max |
metadata
object
|
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 |
notes
string
|
Any additional information pertaining to the business. Allowable Values: 255 char max |
office_location
object
|
Address associated with the business. Allowable Values:
|
office_location.address1
string
|
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
|
Additional address information. Allowable Values: 35 char max |
office_location.city
string
|
City of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max |
office_location.country
string
|
Country of the address. Allowable Values: 40 char max ISO alpha-2 country code required for KYC verification ( |
office_location.postal_code
string
|
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
|
State of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max Valid two-letter abbreviation required for KYC verification ( |
office_location.zip
string
|
United States ZIP code of the address. Allowable Values: 20 char max |
password
string
|
Password for the business account on the Marqeta platform. Allowable Values: 1–255 chars
|
phone
string
|
10-digit telephone number of business. Allowable Values: 255 char max Format: 510-555-1212 or 5105551212 |
primary_contact
object
|
Describes the business' primary contact person. Allowable Values:
|
primary_contact.department
string
|
Business department of the primary contact. Allowable Values: 255 char max |
primary_contact.email
string
|
Email address of the primary contact. Allowable Values: 255 char max |
primary_contact.extension
string
|
Phone extension of the primary contact. Allowable Values: 255 char max |
primary_contact.fax
string
|
Fax number of the primary contact. Allowable Values: 255 char max Format: 510-555-1212 or 5105551212 |
primary_contact.full_name
string
|
Full name of the primary contact. Allowable Values: 255 char max |
primary_contact.mobile
string
|
Mobile phone number of the primary contact. Allowable Values: 255 char max Format: 510-555-1212 or 5105551212 |
primary_contact.phone
string
|
Phone number of the primary contact. Allowable Values: 255 char max Format: 510-555-1212 or 5105551212 |
primary_contact.title
string
|
Title of the primary contact. Allowable Values: 255 char max |
proprietor_is_beneficial_owner
boolean
|
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:
Default value: |
proprietor_or_officer
object
|
Contains information about the proprietor or officer of the business. This object is required for KYC verification in the United States. Allowable Values:
|
proprietor_or_officer.alternative_names
string
|
Alternate names of the business proprietor or officer. Allowable Values: 255 char max |
proprietor_or_officer.dob
datetime
|
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
|
Email address of the business proprietor or officer. Allowable Values: 255 char max |
proprietor_or_officer.first_name
string
|
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
|
Address associated with the business. Allowable Values:
|
proprietor_or_officer.home.address1
string
|
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
|
Additional address information. Allowable Values: 35 char max |
proprietor_or_officer.home.city
string
|
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
|
Country of the address. Allowable Values: 40 char max ISO alpha-2 country code required for KYC verification ( |
proprietor_or_officer.home.postal_code
string
|
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
|
State of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max Valid two-letter abbreviation required for KYC verification ( |
proprietor_or_officer.home.zip
string
|
United States ZIP code of the address. Allowable Values: 20 char max |
proprietor_or_officer.identifications
array of objects
|
One or more objects containing personal identifications of the business proprietor or officer. Allowable Values: Valid array of one or more |
proprietor_or_officer.identifications[].expiration_date
string
|
Expiration date of the identification, if applicable. Allowable Values: Format: yyyy-MM-dd |
proprietor_or_officer.identifications[].type
string
|
Type of identification. NOTE: Full Social Security Number (SSN) is required for US-based cardholder KYC verification.
Nine digits only, no delimiters.
Allowable Values:
|
proprietor_or_officer.identifications[].value
string
|
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
|
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
|
Middle name of business proprietor or officer. Allowable Values: 255 char max |
proprietor_or_officer.phone
string
|
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
|
Social Security Number (SSN) of the business proprietor or officer. Allowable Values: Nine digits, no delimiters.
|
proprietor_or_officer.title
string
|
Title of business proprietor or officer. Allowable Values: 255 char max |
taxpayer_id
string
|
Taxpayer identifier of the business. Allowable Values: 255 char max |
token
string
|
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
|
URL of the business' website. Allowable Values: 255 char max |
Response body
Copy section link
Fields | Description |
---|---|
account_holder_group_token
string
|
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
|
Specifies if the business is in the This field is returned if it exists in the resource. Allowable Values:
|
attestation_consent
boolean
|
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:
|
attestation_date
datetime
|
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
|
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
|
Title of the attester for KYC verification. This field is returned if it exists in the resource. Allowable Values: 64 char max |
authentication
object
|
Contains the cardholder’s email address and password information. Allowable Values:
|
authentication.email_verified
boolean
|
Specifies whether the email address has been verified. Allowable Values:
|
authentication.email_verified_time
datetime
|
Date and time when the email address was verified. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
authentication.last_password_update_channel
string
|
Specifies the channel through which the password was last changed. Allowable Values:
|
authentication.last_password_update_time
datetime
|
Date and time when the password was last changed. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
beneficial_owner1
object
|
Contains information about the beneficial owner of the business, if applicable. Allowable Values:
|
beneficial_owner1.first_name
string
|
First name of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
beneficial_owner1.getdob
datetime
|
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
|
Address associated with the business. Allowable Values:
|
beneficial_owner1.home.address1
string
|
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
|
Additional address information. This field is returned if it exists in the resource. Allowable Values: 35 char max |
beneficial_owner1.home.city
string
|
City of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
beneficial_owner1.home.country
string
|
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
|
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
|
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
|
United States ZIP code of the address. This field is returned if it exists in the resource. Allowable Values: 20 char max |
beneficial_owner1.last_name
string
|
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
|
Middle name of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
beneficial_owner1.phone
string
|
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.title
string
|
Title of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
beneficial_owner2
object
|
Contains information about the beneficial owner of the business, if applicable. Allowable Values:
|
beneficial_owner2.first_name
string
|
First name of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
beneficial_owner2.getdob
datetime
|
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
|
Address associated with the business. Allowable Values:
|
beneficial_owner2.home.address1
string
|
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
|
Additional address information. This field is returned if it exists in the resource. Allowable Values: 35 char max |
beneficial_owner2.home.city
string
|
City of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
beneficial_owner2.home.country
string
|
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
|
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
|
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
|
United States ZIP code of the address. This field is returned if it exists in the resource. Allowable Values: 20 char max |
beneficial_owner2.last_name
string
|
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
|
Middle name of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
beneficial_owner2.phone
string
|
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.title
string
|
Title of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
beneficial_owner3
object
|
Contains information about the beneficial owner of the business, if applicable. Allowable Values:
|
beneficial_owner3.first_name
string
|
First name of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
beneficial_owner3.getdob
datetime
|
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
|
Address associated with the business. Allowable Values:
|
beneficial_owner3.home.address1
string
|
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
|
Additional address information. This field is returned if it exists in the resource. Allowable Values: 35 char max |
beneficial_owner3.home.city
string
|
City of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
beneficial_owner3.home.country
string
|
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
|
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
|
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
|
United States ZIP code of the address. This field is returned if it exists in the resource. Allowable Values: 20 char max |
beneficial_owner3.last_name
string
|
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
|
Middle name of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
beneficial_owner3.phone
string
|
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.title
string
|
Title of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
beneficial_owner4
object
|
Contains information about the beneficial owner of the business, if applicable. Allowable Values:
|
beneficial_owner4.first_name
string
|
First name of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
beneficial_owner4.getdob
datetime
|
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
|
Address associated with the business. Allowable Values:
|
beneficial_owner4.home.address1
string
|
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
|
Additional address information. This field is returned if it exists in the resource. Allowable Values: 35 char max |
beneficial_owner4.home.city
string
|
City of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
beneficial_owner4.home.country
string
|
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
|
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
|
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
|
United States ZIP code of the address. This field is returned if it exists in the resource. Allowable Values: 20 char max |
beneficial_owner4.last_name
string
|
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
|
Middle name of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
beneficial_owner4.phone
string
|
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.title
string
|
Title of the beneficial owner. This field is returned if it exists in the resource. Allowable Values: 255 char max |
business_name_dba
string
|
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
|
Legal name of the business. This field is returned if it exists in the resource. Allowable Values: 255 char max |
business_type
string
|
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
|
Date and time when the business was created, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
date_established
datetime
|
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
|
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
|
General description of the business. This field is returned if it exists in the resource. Allowable Values: 255 char max |
history
string
|
History of the business. This field is returned if it exists in the resource. Allowable Values: 255 char max |
identifications
array of objects
|
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[].expiration_date
string
|
Expiration date for the identification, if applicable. Allowable Values: Format: yyyy-MM-dd |
identifications[].type
string
|
Type of identification. Allowable Values:
|
identifications[].value
string
|
Number associated with the identification. Allowable Values: 255 char max |
in_current_location_since
datetime
|
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
|
Contains information about the organizational structure of the business. Allowable Values:
|
incorporation.address_registered_under
object
|
Address associated with the business. Allowable Values:
|
incorporation.address_registered_under.address1
string
|
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
|
Additional address information. This field is returned if it exists in the resource. Allowable Values: 35 char max |
incorporation.address_registered_under.city
string
|
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
|
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
|
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
|
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
|
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
|
Organizational structure of the business (corporation or sole proprietorship, for example). This field is returned if it exists in the resource. Allowable Values:
|
incorporation.is_public
boolean
|
A value of This field is returned if it exists in the resource. Allowable Values:
|
incorporation.name_registered_under
string
|
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
|
State where the business is incorporated. This field is returned if it exists in the resource. Allowable Values: 255 char max |
incorporation.stock_symbol
string
|
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
|
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
|
IP address of the business. This field is returned if it exists in the resource. Allowable Values: 39 char max |
last_modified_time
datetime
|
Date and time when the business was last modified, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
metadata
object
|
Associates any additional metadata you provide with the business. Metadata is returned if it exists in the resource. Allowable Values: Existing |
notes
string
|
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
|
Address associated with the business. Allowable Values:
|
office_location.address1
string
|
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
|
Additional address information. This field is returned if it exists in the resource. Allowable Values: 35 char max |
office_location.city
string
|
City of the address. This field is returned if it exists in the resource. Allowable Values: 35 char max |
office_location.country
string
|
Country of the address. This field is returned if it exists in the resource. Allowable Values: 40 char max |
office_location.postal_code
string
|
Postal code of the address. This field is returned if it exists in the resource. Allowable Values: 20 char max |
office_location.state
string
|
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
|
United States ZIP code of the address. This field is returned if it exists in the resource. Allowable Values: 20 char max |
password
string
|
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
|
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
|
Describes the business' primary contact person. Allowable Values:
|
primary_contact.department
string
|
Business department of the primary contact. Allowable Values: 255 char max |
primary_contact.email
string
|
Email address of the primary contact. Allowable Values: 255 char max |
primary_contact.extension
string
|
Phone extension of the primary contact. Allowable Values: 255 char max |
primary_contact.fax
string
|
Fax number of the primary contact. Allowable Values: 255 char max Format: 510-555-1212 or 5105551212 |
primary_contact.full_name
string
|
Full name of the primary contact. Allowable Values: 255 char max |
primary_contact.mobile
string
|
Mobile phone number of the primary contact. Allowable Values: 255 char max Format: 510-555-1212 or 5105551212 |
primary_contact.phone
string
|
Phone number of the primary contact. Allowable Values: 255 char max Format: 510-555-1212 or 5105551212 |
primary_contact.title
string
|
Title of the primary contact. Allowable Values: 255 char max |
proprietor_is_beneficial_owner
boolean
|
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:
|
proprietor_or_officer
object
|
Contains information about the proprietor or officer of the business. Allowable Values:
|
proprietor_or_officer.alternative_names
string
|
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.dob
datetime
|
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
|
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
|
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
|
Address associated with the business. Allowable Values:
|
proprietor_or_officer.home.address1
string
|
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
|
Additional address information. This field is returned if it exists in the resource. Allowable Values: 35 char max |
proprietor_or_officer.home.city
string
|
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
|
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
|
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
|
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
|
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
|
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 |
proprietor_or_officer.identifications[].expiration_date
string
|
Expiration date for the identification, if applicable. Allowable Values: Format: yyyy-MM-dd |
proprietor_or_officer.identifications[].type
string
|
Type of identification. Allowable Values:
|
proprietor_or_officer.identifications[].value
string
|
Number associated with the identification. Allowable Values: 255 char max |
proprietor_or_officer.last_name
string
|
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
|
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.phone
string
|
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
|
Social Security Number (SSN) 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
|
Title of the business proprietor or officer. This field is returned if it exists in the resource. Allowable Values: 255 char max |
status
string
|
Specifies the state of the business on the Marqeta platform. This field is returned if it exists in the resource. Allowable Values:
|
taxpayer_id
string
|
Taxpayer identifier of the business. This field is returned if it exists in the resource. Allowable Values: 255 char max |
token
string
|
Unique identifier of the business resource. This field is always returned. Allowable Values: 1–36 chars |
website
string
|
URL of the business' website. This field is returned if it exists in the resource. Allowable Values: 255 char max |
List businesses
Copy section link
Action: GET
Endpoint: /businesses
To return an array of all businesses, send a GET
request to the /businesses
endpoint.
To narrow your result set to businesses that match a particular legal or fictitious name, include the appropriate parameters from the following query parameters table. This endpoint also supports field filtering and sorting and pagination.
URL query parameters
Copy section link
Fields | Description |
---|---|
count
integer
|
The number of business resources to retrieve. Allowable Values: 1-10 |
start_index
integer
|
Sort order index of the first resource in the returned array. Allowable Values: Any integer |
business_name_dba
string
|
Fictitious or "doing business as (DBA)" name of the business. Allowable Values: Existing DBA name of the business |
business_name_legal
string
|
Legal name of the business. Allowable Values: Existing legal name of the business |
search_type
string
|
Specifies the search type for the query. Allowable Values:
|
fields
string
|
Comma-delimited list of fields to return ( Allowable Values: Comma-delimited list of fields, or blank |
sort_by
string
|
Field on which to sort.
Use any field in the resource model, or one of the system fields Allowable Values:
Default value: |
Response body
Copy section link
Fields | Description |
---|---|
count
integer
|
Number of resources to retrieve. This field is returned if there are resources in your returned array. Allowable Values: 1-10 |
data
array of objects
|
Array of business objects. Objects are returned as appropriate to your query. Allowable Values: Valid array of one or more business objects |
data[].account_holder_group_token
string
|
Existing account holder group token that associates the specified account holder group with the business.
Send a Allowable Values: 36 char max |
data[].active
boolean
|
Specifies if the business is in the Allowable Values:
Default value: |
data[].attestation_consent
boolean
|
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:
|
data[].attestation_date
datetime
|
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 |
data[].attester_name
string
|
Name of the attester for KYC verification. This field is required for KYC verification (US-based accounts only). Allowable Values: 64 char max |
data[].attester_title
string
|
Title of the attester for KYC verification. Allowable Values: 64 char max |
data[].beneficial_owner1
object
|
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 has a beneficial owner.
Do not include information about the proprietor or business officer in a Allowable Values:
|
data[].beneficial_owner1.dob
datetime
|
Date of birth of the beneficial owner. Allowable Values: Format: yyyy-MM-dd |
data[].beneficial_owner1.first_name
string
|
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 |
data[].beneficial_owner1.home
object
|
Address associated with the business. Allowable Values:
|
data[].beneficial_owner1.home.address1
string
|
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 |
data[].beneficial_owner1.home.address2
string
|
Additional address information. Allowable Values: 35 char max |
data[].beneficial_owner1.home.city
string
|
City of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max |
data[].beneficial_owner1.home.country
string
|
Country of the address. Allowable Values: 40 char max ISO alpha-2 country code required for KYC verification ( |
data[].beneficial_owner1.home.postal_code
string
|
Postal code of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 20 char max |
data[].beneficial_owner1.home.state
string
|
State of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max Valid two-letter abbreviation required for KYC verification ( |
data[].beneficial_owner1.home.zip
string
|
United States ZIP code of the address. Allowable Values: 20 char max |
data[].beneficial_owner1.last_name
string
|
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 |
data[].beneficial_owner1.middle_name
string
|
Middle name of the beneficial owner. Allowable Values: 255 char max |
data[].beneficial_owner1.phone
string
|
Ten-digit phone number of the beneficial owner. Allowable Values: Format: 510-555-1212 or 5105551212 |
data[].beneficial_owner1.ssn
string
|
Nine-digit Social Security Number (SSN) of the beneficial owner. Allowable Values: Digits only, do not use separators. For example: 123456789 |
data[].beneficial_owner1.title
string
|
Title of the beneficial owner. Allowable Values: 255 char max |
data[].beneficial_owner2
object
|
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 has a beneficial owner.
Do not include information about the proprietor or business officer in a Allowable Values:
|
data[].beneficial_owner2.dob
datetime
|
Date of birth of the beneficial owner. Allowable Values: Format: yyyy-MM-dd |
data[].beneficial_owner2.first_name
string
|
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 |
data[].beneficial_owner2.home
object
|
Address associated with the business. Allowable Values:
|
data[].beneficial_owner2.home.address1
string
|
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 |
data[].beneficial_owner2.home.address2
string
|
Additional address information. Allowable Values: 35 char max |
data[].beneficial_owner2.home.city
string
|
City of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max |
data[].beneficial_owner2.home.country
string
|
Country of the address. Allowable Values: 40 char max ISO alpha-2 country code required for KYC verification ( |
data[].beneficial_owner2.home.postal_code
string
|
Postal code of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 20 char max |
data[].beneficial_owner2.home.state
string
|
State of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max Valid two-letter abbreviation required for KYC verification ( |
data[].beneficial_owner2.home.zip
string
|
United States ZIP code of the address. Allowable Values: 20 char max |
data[].beneficial_owner2.last_name
string
|
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 |
data[].beneficial_owner2.middle_name
string
|
Middle name of the beneficial owner. Allowable Values: 255 char max |
data[].beneficial_owner2.phone
string
|
Ten-digit phone number of the beneficial owner. Allowable Values: Format: 510-555-1212 or 5105551212 |
data[].beneficial_owner2.ssn
string
|
Nine-digit Social Security Number (SSN) of the beneficial owner. Allowable Values: Digits only, do not use separators. For example: 123456789 |
data[].beneficial_owner2.title
string
|
Title of the beneficial owner. Allowable Values: 255 char max |
data[].beneficial_owner3
object
|
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 has a beneficial owner.
Do not include information about the proprietor or business officer in a Allowable Values:
|
data[].beneficial_owner3.dob
datetime
|
Date of birth of the beneficial owner. Allowable Values: Format: yyyy-MM-dd |
data[].beneficial_owner3.first_name
string
|
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 |
data[].beneficial_owner3.home
object
|
Address associated with the business. Allowable Values:
|
data[].beneficial_owner3.home.address1
string
|
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 |
data[].beneficial_owner3.home.address2
string
|
Additional address information. Allowable Values: 35 char max |
data[].beneficial_owner3.home.city
string
|
City of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max |
data[].beneficial_owner3.home.country
string
|
Country of the address. Allowable Values: 40 char max ISO alpha-2 country code required for KYC verification ( |
data[].beneficial_owner3.home.postal_code
string
|
Postal code of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 20 char max |
data[].beneficial_owner3.home.state
string
|
State of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max Valid two-letter abbreviation required for KYC verification ( |
data[].beneficial_owner3.home.zip
string
|
United States ZIP code of the address. Allowable Values: 20 char max |
data[].beneficial_owner3.last_name
string
|
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 |
data[].beneficial_owner3.middle_name
string
|
Middle name of the beneficial owner. Allowable Values: 255 char max |
data[].beneficial_owner3.phone
string
|
Ten-digit phone number of the beneficial owner. Allowable Values: Format: 510-555-1212 or 5105551212 |
data[].beneficial_owner3.ssn
string
|
Nine-digit Social Security Number (SSN) of the beneficial owner. Allowable Values: Digits only, do not use separators. For example: 123456789 |
data[].beneficial_owner3.title
string
|
Title of the beneficial owner. Allowable Values: 255 char max |
data[].beneficial_owner4
object
|
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 has a beneficial owner.
Do not include information about the proprietor or business officer in a Allowable Values:
|
data[].beneficial_owner4.dob
datetime
|
Date of birth of the beneficial owner. Allowable Values: Format: yyyy-MM-dd |
data[].beneficial_owner4.first_name
string
|
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 |
data[].beneficial_owner4.home
object
|
Address associated with the business. Allowable Values:
|
data[].beneficial_owner4.home.address1
string
|
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 |
data[].beneficial_owner4.home.address2
string
|
Additional address information. Allowable Values: 35 char max |
data[].beneficial_owner4.home.city
string
|
City of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max |
data[].beneficial_owner4.home.country
string
|
Country of the address. Allowable Values: 40 char max ISO alpha-2 country code required for KYC verification ( |
data[].beneficial_owner4.home.postal_code
string
|
Postal code of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 20 char max |
data[].beneficial_owner4.home.state
string
|
State of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max Valid two-letter abbreviation required for KYC verification ( |
data[].beneficial_owner4.home.zip
string
|
United States ZIP code of the address. Allowable Values: 20 char max |
data[].beneficial_owner4.last_name
string
|
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 |
data[].beneficial_owner4.middle_name
string
|
Middle name of the beneficial owner. Allowable Values: 255 char max |
data[].beneficial_owner4.phone
string
|
Ten-digit phone number of the beneficial owner. Allowable Values: Format: 510-555-1212 or 5105551212 |
data[].beneficial_owner4.ssn
string
|
Nine-digit Social Security Number (SSN) of the beneficial owner. Allowable Values: Digits only, do not use separators. For example: 123456789 |
data[].beneficial_owner4.title
string
|
Title of the beneficial owner. Allowable Values: 255 char max |
data[].business_name_dba
string
|
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 |
data[].business_name_legal
string
|
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 |
data[].business_type
string
|
Indicates the type of business, for example B2B (business-to-business) or B2C (business-to-consumer). Allowable Values: 255 char max |
data[].date_established
datetime
|
Date the business was established. This field is required for KYC verification (US-based accounts only). Allowable Values: Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ssZ |
data[].duns_number
string
|
Data Universal Numbering System (DUNS) number of the business. Allowable Values: 255 char max |
data[].general_business_description
string
|
General description of the business. Allowable Values: 255 char max |
data[].history
string
|
History of the business. Allowable Values: 255 char max |
data[].identifications
array of objects
|
One or more objects containing identifications associated with the business. Allowable Values: Valid array of one or more |
data[].identifications[].expiration_date
string
|
Expiration date of the identification, if applicable. Allowable Values: Format: yyyy-MM-dd |
data[].identifications[].type
string
|
Type of identification. NOTE: Full Social Security Number (SSN) is required for US-based cardholder KYC verification.
Nine digits only, no delimiters.
Allowable Values:
|
data[].identifications[].value
string
|
Number associated with the identification. Allowable Values: 255 char max NOTE: Digits only, do not use separators. For example: 123456789 |
data[].in_current_location_since
datetime
|
Date on which the business office opened in its current location. Allowable Values: Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ssZ |
data[].incorporation
object
|
Contains information about the organizational structure of the business. This object is required for KYC verification (US-based accounts only). Allowable Values:
|
data[].incorporation.address_registered_under
object
|
Address associated with the business. Allowable Values:
|
data[].incorporation.address_registered_under.address1
string
|
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 |
data[].incorporation.address_registered_under.address2
string
|
Additional address information. Allowable Values: 35 char max |
data[].incorporation.address_registered_under.city
string
|
City of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max |
data[].incorporation.address_registered_under.country
string
|
Country of the address. Allowable Values: 40 char max ISO alpha-2 country code required for KYC verification ( |
data[].incorporation.address_registered_under.postal_code
string
|
Postal code of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 20 char max |
data[].incorporation.address_registered_under.state
string
|
State of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max Valid two-letter abbreviation required for KYC verification ( |
data[].incorporation.address_registered_under.zip
string
|
United States ZIP code of the address. Allowable Values: 20 char max |
data[].incorporation.incorporation_type
string
|
Organizational structure of the business, such as corporation or sole proprietorship. This field is required for KYC verification (US-based accounts only). Allowable Values:
|
data[].incorporation.is_public
boolean
|
A value of Allowable Values:
Default value: |
data[].incorporation.name_registered_under
string
|
Name under which the business is registered. Allowable Values: 255 char max |
data[].incorporation.state_of_incorporation
string
|
State where the business is incorporated. This field is required for KYC verification (US-based accounts only). Allowable Values: 255 char max Valid two-letter state, provincial, or territorial abbreviation required for KYC verification ( |
data[].incorporation.stock_symbol
string
|
Business stock symbol. Allowable Values: 255 char max |
data[].international_office_locations
string
|
Locations of the business' offices outside the US. Allowable Values: 255 char max |
data[].ip_address
string
|
IP address of the business. Allowable Values: 39 char max |
data[].metadata
object
|
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 |
data[].notes
string
|
Any additional information pertaining to the business. Allowable Values: 255 char max |
data[].office_location
object
|
Address associated with the business. Allowable Values:
|
data[].office_location.address1
string
|
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 |
data[].office_location.address2
string
|
Additional address information. Allowable Values: 35 char max |
data[].office_location.city
string
|
City of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max |
data[].office_location.country
string
|
Country of the address. Allowable Values: 40 char max ISO alpha-2 country code required for KYC verification ( |
data[].office_location.postal_code
string
|
Postal code of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 20 char max |
data[].office_location.state
string
|
State of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max Valid two-letter abbreviation required for KYC verification ( |
data[].office_location.zip
string
|
United States ZIP code of the address. Allowable Values: 20 char max |
data[].password
string
|
Password for the business account on the Marqeta platform. Allowable Values: 1–255 chars
|
data[].phone
string
|
10-digit telephone number of business. Allowable Values: 255 char max Format: 510-555-1212 or 5105551212 |
data[].primary_contact
object
|
Describes the business' primary contact person. Allowable Values:
|
data[].primary_contact.department
string
|
Business department of the primary contact. Allowable Values: 255 char max |
data[].primary_contact.email
string
|
Email address of the primary contact. Allowable Values: 255 char max |
data[].primary_contact.extension
string
|
Phone extension of the primary contact. Allowable Values: 255 char max |
data[].primary_contact.fax
string
|
Fax number of the primary contact. Allowable Values: 255 char max Format: 510-555-1212 or 5105551212 |
data[].primary_contact.full_name
string
|
Full name of the primary contact. Allowable Values: 255 char max |
data[].primary_contact.mobile
string
|
Mobile phone number of the primary contact. Allowable Values: 255 char max Format: 510-555-1212 or 5105551212 |
data[].primary_contact.phone
string
|
Phone number of the primary contact. Allowable Values: 255 char max Format: 510-555-1212 or 5105551212 |
data[].primary_contact.title
string
|
Title of the primary contact. Allowable Values: 255 char max |
data[].proprietor_is_beneficial_owner
boolean
|
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:
Default value: |
data[].proprietor_or_officer
object
|
Contains information about the proprietor or officer of the business. This object is required for KYC verification in the United States. Allowable Values:
|
data[].proprietor_or_officer.alternative_names
string
|
Alternate names of the business proprietor or officer. Allowable Values: 255 char max |
data[].proprietor_or_officer.dob
datetime
|
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 |
data[].proprietor_or_officer.email
string
|
Email address of the business proprietor or officer. Allowable Values: 255 char max |
data[].proprietor_or_officer.first_name
string
|
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 |
data[].proprietor_or_officer.home
object
|
Address associated with the business. Allowable Values:
|
data[].proprietor_or_officer.home.address1
string
|
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 |
data[].proprietor_or_officer.home.address2
string
|
Additional address information. Allowable Values: 35 char max |
data[].proprietor_or_officer.home.city
string
|
City of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max |
data[].proprietor_or_officer.home.country
string
|
Country of the address. Allowable Values: 40 char max ISO alpha-2 country code required for KYC verification ( |
data[].proprietor_or_officer.home.postal_code
string
|
Postal code of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 20 char max |
data[].proprietor_or_officer.home.state
string
|
State of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max Valid two-letter abbreviation required for KYC verification ( |
data[].proprietor_or_officer.home.zip
string
|
United States ZIP code of the address. Allowable Values: 20 char max |
data[].proprietor_or_officer.identifications
array of objects
|
One or more objects containing personal identifications of the business proprietor or officer. Allowable Values: Valid array of one or more |
data[].proprietor_or_officer.identifications[].expiration_date
string
|
Expiration date of the identification, if applicable. Allowable Values: Format: yyyy-MM-dd |
data[].proprietor_or_officer.identifications[].type
string
|
Type of identification. NOTE: Full Social Security Number (SSN) is required for US-based cardholder KYC verification.
Nine digits only, no delimiters.
Allowable Values:
|
data[].proprietor_or_officer.identifications[].value
string
|
Number associated with the identification. Allowable Values: 255 char max NOTE: Digits only, do not use separators. For example: 123456789 |
data[].proprietor_or_officer.last_name
string
|
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 |
data[].proprietor_or_officer.middle_name
string
|
Middle name of business proprietor or officer. Allowable Values: 255 char max |
data[].proprietor_or_officer.phone
string
|
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. |
data[].proprietor_or_officer.ssn
string
|
Social Security Number (SSN) of the business proprietor or officer. Allowable Values: Nine digits, no delimiters.
|
data[].proprietor_or_officer.title
string
|
Title of business proprietor or officer. Allowable Values: 255 char max |
data[].taxpayer_id
string
|
Taxpayer identifier of the business. Allowable Values: 255 char max |
data[].token
string
|
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 |
data[].website
string
|
URL of the business' website. Allowable Values: 255 char max |
end_index
integer
|
Sort order index of the last resource in the returned array. This field is returned if there are resources in your returned array. Allowable Values: Any integer |
is_more
boolean
|
A value of This field is returned if there are resources in your returned array. Allowable Values:
|
start_index
integer
|
Sort order index of the first resource in the returned array. This field is returned if there are resources in your returned array. Allowable Values: Any integer |
Search businesses
Copy section link
Action: POST
Endpoint: /businesses/lookup
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
Copy section link
Fields | Description |
---|---|
dda
string
|
Deposit account number of the business. Allowable Values: 17 char max Send a Send a |
Response body
Copy section link
Fields | Description |
---|---|
account_holder_group_token
string
|
Existing account holder group token that associates the specified account holder group with the business.
Send a Allowable Values: 36 char max |
active
boolean
|
Specifies if the business is in the Allowable Values:
Default value: |
attestation_consent
boolean
|
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:
|
attestation_date
datetime
|
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
|
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
|
Title of the attester for KYC verification. Allowable Values: 64 char max |
beneficial_owner1
object
|
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 has a beneficial owner.
Do not include information about the proprietor or business officer in a Allowable Values:
|
beneficial_owner1.dob
datetime
|
Date of birth of the beneficial owner. Allowable Values: Format: yyyy-MM-dd |
beneficial_owner1.first_name
string
|
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
|
Address associated with the business. Allowable Values:
|
beneficial_owner1.home.address1
string
|
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
|
Additional address information. Allowable Values: 35 char max |
beneficial_owner1.home.city
string
|
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
|
Country of the address. Allowable Values: 40 char max ISO alpha-2 country code required for KYC verification ( |
beneficial_owner1.home.postal_code
string
|
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
|
State of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max Valid two-letter abbreviation required for KYC verification ( |
beneficial_owner1.home.zip
string
|
United States ZIP code of the address. Allowable Values: 20 char max |
beneficial_owner1.last_name
string
|
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
|
Middle name of the beneficial owner. Allowable Values: 255 char max |
beneficial_owner1.phone
string
|
Ten-digit phone number of the beneficial owner. Allowable Values: Format: 510-555-1212 or 5105551212 |
beneficial_owner1.ssn
string
|
Nine-digit Social Security Number (SSN) of the beneficial owner. Allowable Values: Digits only, do not use separators. For example: 123456789 |
beneficial_owner1.title
string
|
Title of the beneficial owner. Allowable Values: 255 char max |
beneficial_owner2
object
|
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 has a beneficial owner.
Do not include information about the proprietor or business officer in a Allowable Values:
|
beneficial_owner2.dob
datetime
|
Date of birth of the beneficial owner. Allowable Values: Format: yyyy-MM-dd |
beneficial_owner2.first_name
string
|
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
|
Address associated with the business. Allowable Values:
|
beneficial_owner2.home.address1
string
|
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
|
Additional address information. Allowable Values: 35 char max |
beneficial_owner2.home.city
string
|
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
|
Country of the address. Allowable Values: 40 char max ISO alpha-2 country code required for KYC verification ( |
beneficial_owner2.home.postal_code
string
|
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
|
State of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max Valid two-letter abbreviation required for KYC verification ( |
beneficial_owner2.home.zip
string
|
United States ZIP code of the address. Allowable Values: 20 char max |
beneficial_owner2.last_name
string
|
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
|
Middle name of the beneficial owner. Allowable Values: 255 char max |
beneficial_owner2.phone
string
|
Ten-digit phone number of the beneficial owner. Allowable Values: Format: 510-555-1212 or 5105551212 |
beneficial_owner2.ssn
string
|
Nine-digit Social Security Number (SSN) of the beneficial owner. Allowable Values: Digits only, do not use separators. For example: 123456789 |
beneficial_owner2.title
string
|
Title of the beneficial owner. Allowable Values: 255 char max |
beneficial_owner3
object
|
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 has a beneficial owner.
Do not include information about the proprietor or business officer in a Allowable Values:
|
beneficial_owner3.dob
datetime
|
Date of birth of the beneficial owner. Allowable Values: Format: yyyy-MM-dd |
beneficial_owner3.first_name
string
|
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
|
Address associated with the business. Allowable Values:
|
beneficial_owner3.home.address1
string
|
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
|
Additional address information. Allowable Values: 35 char max |
beneficial_owner3.home.city
string
|
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
|
Country of the address. Allowable Values: 40 char max ISO alpha-2 country code required for KYC verification ( |
beneficial_owner3.home.postal_code
string
|
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
|
State of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max Valid two-letter abbreviation required for KYC verification ( |
beneficial_owner3.home.zip
string
|
United States ZIP code of the address. Allowable Values: 20 char max |
beneficial_owner3.last_name
string
|
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
|
Middle name of the beneficial owner. Allowable Values: 255 char max |
beneficial_owner3.phone
string
|
Ten-digit phone number of the beneficial owner. Allowable Values: Format: 510-555-1212 or 5105551212 |
beneficial_owner3.ssn
string
|
Nine-digit Social Security Number (SSN) of the beneficial owner. Allowable Values: Digits only, do not use separators. For example: 123456789 |
beneficial_owner3.title
string
|
Title of the beneficial owner. Allowable Values: 255 char max |
beneficial_owner4
object
|
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 has a beneficial owner.
Do not include information about the proprietor or business officer in a Allowable Values:
|
beneficial_owner4.dob
datetime
|
Date of birth of the beneficial owner. Allowable Values: Format: yyyy-MM-dd |
beneficial_owner4.first_name
string
|
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
|
Address associated with the business. Allowable Values:
|
beneficial_owner4.home.address1
string
|
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
|
Additional address information. Allowable Values: 35 char max |
beneficial_owner4.home.city
string
|
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
|
Country of the address. Allowable Values: 40 char max ISO alpha-2 country code required for KYC verification ( |
beneficial_owner4.home.postal_code
string
|
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
|
State of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max Valid two-letter abbreviation required for KYC verification ( |
beneficial_owner4.home.zip
string
|
United States ZIP code of the address. Allowable Values: 20 char max |
beneficial_owner4.last_name
string
|
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
|
Middle name of the beneficial owner. Allowable Values: 255 char max |
beneficial_owner4.phone
string
|
Ten-digit phone number of the beneficial owner. Allowable Values: Format: 510-555-1212 or 5105551212 |
beneficial_owner4.ssn
string
|
Nine-digit Social Security Number (SSN) of the beneficial owner. Allowable Values: Digits only, do not use separators. For example: 123456789 |
beneficial_owner4.title
string
|
Title of the beneficial owner. Allowable Values: 255 char max |
business_name_dba
string
|
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
|
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
|
Indicates the type of business, for example B2B (business-to-business) or B2C (business-to-consumer). Allowable Values: 255 char max |
date_established
datetime
|
Date the business was established. This field is required for KYC verification (US-based accounts only). Allowable Values: Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ssZ |
duns_number
string
|
Data Universal Numbering System (DUNS) number of the business. Allowable Values: 255 char max |
general_business_description
string
|
General description of the business. Allowable Values: 255 char max |
history
string
|
History of the business. Allowable Values: 255 char max |
identifications
array of objects
|
One or more objects containing identifications associated with the business. Allowable Values: Valid array of one or more |
identifications[].expiration_date
string
|
Expiration date of the identification, if applicable. Allowable Values: Format: yyyy-MM-dd |
identifications[].type
string
|
Type of identification. NOTE: Full Social Security Number (SSN) is required for US-based cardholder KYC verification.
Nine digits only, no delimiters.
Allowable Values:
|
identifications[].value
string
|
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
|
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
|
Contains information about the organizational structure of the business. This object is required for KYC verification (US-based accounts only). Allowable Values:
|
incorporation.address_registered_under
object
|
Address associated with the business. Allowable Values:
|
incorporation.address_registered_under.address1
string
|
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
|
Additional address information. Allowable Values: 35 char max |
incorporation.address_registered_under.city
string
|
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
|
Country of the address. Allowable Values: 40 char max ISO alpha-2 country code required for KYC verification ( |
incorporation.address_registered_under.postal_code
string
|
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
|
State of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max Valid two-letter abbreviation required for KYC verification ( |
incorporation.address_registered_under.zip
string
|
United States ZIP code of the address. Allowable Values: 20 char max |
incorporation.incorporation_type
string
|
Organizational structure of the business, such as corporation or sole proprietorship. This field is required for KYC verification (US-based accounts only). Allowable Values:
|
incorporation.is_public
boolean
|
A value of Allowable Values:
Default value: |
incorporation.name_registered_under
string
|
Name under which the business is registered. Allowable Values: 255 char max |
incorporation.state_of_incorporation
string
|
State where the business is incorporated. This field is required for KYC verification (US-based accounts only). Allowable Values: 255 char max Valid two-letter state, provincial, or territorial abbreviation required for KYC verification ( |
incorporation.stock_symbol
string
|
Business stock symbol. Allowable Values: 255 char max |
international_office_locations
string
|
Locations of the business' offices outside the US. Allowable Values: 255 char max |
ip_address
string
|
IP address of the business. Allowable Values: 39 char max |
metadata
object
|
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 |
notes
string
|
Any additional information pertaining to the business. Allowable Values: 255 char max |
office_location
object
|
Address associated with the business. Allowable Values:
|
office_location.address1
string
|
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
|
Additional address information. Allowable Values: 35 char max |
office_location.city
string
|
City of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max |
office_location.country
string
|
Country of the address. Allowable Values: 40 char max ISO alpha-2 country code required for KYC verification ( |
office_location.postal_code
string
|
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
|
State of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max Valid two-letter abbreviation required for KYC verification ( |
office_location.zip
string
|
United States ZIP code of the address. Allowable Values: 20 char max |
password
string
|
Password for the business account on the Marqeta platform. Allowable Values: 1–255 chars
|
phone
string
|
10-digit telephone number of business. Allowable Values: 255 char max Format: 510-555-1212 or 5105551212 |
primary_contact
object
|
Describes the business' primary contact person. Allowable Values:
|
primary_contact.department
string
|
Business department of the primary contact. Allowable Values: 255 char max |
primary_contact.email
string
|
Email address of the primary contact. Allowable Values: 255 char max |
primary_contact.extension
string
|
Phone extension of the primary contact. Allowable Values: 255 char max |
primary_contact.fax
string
|
Fax number of the primary contact. Allowable Values: 255 char max Format: 510-555-1212 or 5105551212 |
primary_contact.full_name
string
|
Full name of the primary contact. Allowable Values: 255 char max |
primary_contact.mobile
string
|
Mobile phone number of the primary contact. Allowable Values: 255 char max Format: 510-555-1212 or 5105551212 |
primary_contact.phone
string
|
Phone number of the primary contact. Allowable Values: 255 char max Format: 510-555-1212 or 5105551212 |
primary_contact.title
string
|
Title of the primary contact. Allowable Values: 255 char max |
proprietor_is_beneficial_owner
boolean
|
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:
Default value: |
proprietor_or_officer
object
|
Contains information about the proprietor or officer of the business. This object is required for KYC verification in the United States. Allowable Values:
|
proprietor_or_officer.alternative_names
string
|
Alternate names of the business proprietor or officer. Allowable Values: 255 char max |
proprietor_or_officer.dob
datetime
|
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
|
Email address of the business proprietor or officer. Allowable Values: 255 char max |
proprietor_or_officer.first_name
string
|
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
|
Address associated with the business. Allowable Values:
|
proprietor_or_officer.home.address1
string
|
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
|
Additional address information. Allowable Values: 35 char max |
proprietor_or_officer.home.city
string
|
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
|
Country of the address. Allowable Values: 40 char max ISO alpha-2 country code required for KYC verification ( |
proprietor_or_officer.home.postal_code
string
|
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
|
State of the address. This field is required for KYC verification (US-based accounts only). Allowable Values: 35 char max Valid two-letter abbreviation required for KYC verification ( |
proprietor_or_officer.home.zip
string
|
United States ZIP code of the address. Allowable Values: 20 char max |
proprietor_or_officer.identifications
array of objects
|
One or more objects containing personal identifications of the business proprietor or officer. Allowable Values: Valid array of one or more |
proprietor_or_officer.identifications[].expiration_date
string
|
Expiration date of the identification, if applicable. Allowable Values: Format: yyyy-MM-dd |
proprietor_or_officer.identifications[].type
string
|
Type of identification. NOTE: Full Social Security Number (SSN) is required for US-based cardholder KYC verification.
Nine digits only, no delimiters.
Allowable Values:
|
proprietor_or_officer.identifications[].value
string
|
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
|
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
|
Middle name of business proprietor or officer. Allowable Values: 255 char max |
proprietor_or_officer.phone
string
|
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
|
Social Security Number (SSN) of the business proprietor or officer. Allowable Values: Nine digits, no delimiters.
|
proprietor_or_officer.title
string
|
Title of business proprietor or officer. Allowable Values: 255 char max |
taxpayer_id
string
|
Taxpayer identifier of the business. Allowable Values: 255 char max |
token
string
|
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
|
URL of the business' website. Allowable Values: 255 char max |
List business children
Copy section link
Action: GET
Endpoint: /businesses/{parent_token}/children
To return an array of all child cardholders of a particular business, send a GET
request to the /businesses/{parent_token}/children
endpoint.
Include the parent_token
as a URL path parameter.
This endpoint supports field filtering.
URL path parameters
Copy section link
Fields | Description |
---|---|
parent_token
string
|
Unique identifier of the parent business. Allowable Values: Existing business resource token |
URL query parameters
Copy section link
Fields | Description |
---|---|
count
integer
|
Number of child cardholders to retrieve. Allowable Values: 1-10 |
start_index
integer
|
Sort order index of the first resource in the returned array. Allowable Values: Any integer |
fields
string
|
Comma-delimited list of fields to return ( Allowable Values: Comma-delimited list of fields, or blank |
sort_by
string
|
Field on which to sort.
Use any field in the resource model, or one of the system fields Allowable Values:
Default value: |
Response body
Copy section link
Fields | Description |
---|---|
count
integer
|
Number of user resources to retrieve. This field is returned if there are resources in your returned array. Allowable Values: 1-10 |
data
array of objects
|
Array of user objects. Objects are returned as appropriate to your query. Allowable Values: One or more user objects |
data[].account_holder_group_token
string
|
Associates the specified account holder group with the cardholder. Allowable Values: 36 char max |
data[].active
boolean
|
Specifies if the cardholder is in the Allowable Values:
|
data[].address1
string
|
Cardholder’s address. Allowable Values: 255 char max |
data[].address2
string
|
Additional address information for the cardholder. Allowable Values: 255 char max |
data[].authentication
object
|
Contains the cardholder’s email address and password information. Allowable Values:
|
data[].authentication.email_verified
boolean
|
Specifies whether the email address has been verified. Allowable Values:
|
data[].authentication.email_verified_time
datetime
|
Date and time when the email address was verified. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
data[].authentication.last_password_update_channel
string
|
Specifies the channel through which the password was last changed. Allowable Values:
|
data[].authentication.last_password_update_time
datetime
|
Date and time when the password was last changed. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
data[].birth_date
string
|
Cardholder’s date of birth. Allowable Values: Format: yyyy-MM-dd |
data[].business_token
string
|
Unique identifier of the business resource. Allowable Values: Existing business resource token |
data[].city
string
|
City where the cardholder resides. Allowable Values: 40 char max |
data[].company
string
|
Company name. Allowable Values: 255 char max |
data[].corporate_card_holder
boolean
|
Specifies if the cardholder holds a corporate card. Allowable Values:
|
data[].country
string
|
Country where the cardholder resides. Allowable Values: 40 char max |
data[].created_time
datetime
|
Date and time when the resource was created, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
data[].email
string
|
Valid email address of the cardholder. Allowable Values: 1–255 chars |
data[].first_name
string
|
Cardholder’s first name. Allowable Values: 40 char max |
data[].gender
string
|
Gender of the cardholder. Allowable Values:
|
data[].honorific
string
|
Cardholder’s title or prefix: Dr., Miss, Mr., Ms., and so on. Allowable Values: 10 char max |
data[].id_card_expiration_date
string
|
Expiration date of the cardholder’s identification. Allowable Values: Format: yyyy-MM-dd |
data[].id_card_number
string
|
Cardholder’s identification card number. Allowable Values: 255 char max |
data[].identifications
array of objects
|
One or more objects containing identifications associated with the cardholder. Allowable Values: Valid array of one or more |
data[].identifications[].expiration_date
string
|
Expiration date for the identification, if applicable. Allowable Values: Format: yyyy-MM-dd |
data[].identifications[].type
string
|
Type of identification. Allowable Values:
|
data[].identifications[].value
string
|
Number associated with the identification. Allowable Values: 255 char max |
data[].ip_address
string
|
Cardholder’s IP address. Allowable Values: 39 char max |
data[].last_modified_time
datetime
|
Date and time when the resource was last updated, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
data[].last_name
string
|
Cardholder’s last name. Allowable Values: 40 char max |
data[].metadata
object
|
Associates any additional metadata you provide with the cardholder. Allowable Values: You can define the names and values of up to 20 fields in the format |
data[].middle_name
string
|
Cardholder’s middle name. Allowable Values: 40 char max |
data[].nationality
string
|
Cardholder’s nationality. Allowable Values: 255 char max |
data[].notes
string
|
Any additional information pertaining to the cardholder. Allowable Values: 255 char max |
data[].parent_token
string
|
Unique identifier of the parent user or business resource. Allowable Values: 1–36 chars |
data[].passport_expiration_date
string
|
Expiration date of the cardholder’s passport. Allowable Values: Format: yyyy-MM-dd |
data[].passport_number
string
|
Cardholder’s passport number. Allowable Values: 40 char max |
data[].password
string
|
Password to the cardholder’s user account on the Marqeta platform. Allowable Values: 1–255 chars |
data[].phone
string
|
Cardholder’s telephone number. Allowable Values: 255 char max |
data[].postal_code
string
|
Postal code of the cardholder’s address. Allowable Values: 10 char max |
data[].ssn
string
|
Cardholder’s Social Security Number (SSN). Allowable Values: Nine digits only, no delimiters. |
data[].state
string
|
State or province where the cardholder resides. Allowable Values: 2 char max |
data[].status
string
|
Specifies the status of the cardholder on the Marqeta platform. Allowable Values:
|
data[].token
string
|
Unique identifier of the cardholder. Allowable Values: 1–36 chars |
data[].uses_parent_account
boolean
|
Indicates whether the child shares balances with the parent ( Allowable Values:
|
data[].zip
string
|
United States ZIP code of the cardholder’s address. Allowable Values: 10 char max |
end_index
integer
|
Sort order index of the first resource in the returned array. This field is returned if there are resources in your returned array. Allowable Values: Any integer |
is_more
boolean
|
A value of This field is returned if there are resources in your returned array. Allowable Values:
|
start_index
integer
|
Sort order index of the first resource in the returned array. This field is returned if there are resources in your returned array. Allowable Values: Any integer |
Retrieve business
Copy section link
Action: GET
Endpoint: /businesses/{token}