/
135 minute read
March 30, 2022

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 business parent’s account balances, and the user’s children are configured to use the business parent’s account balances. For more information on account holders, see About Account Holders.

Create business

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

UNVERIFIED

No

Cannot load funds.

Conditionally

LIMITED

No

Restricted by rules in accountholdergroups.pre_kyc_controls.

Never

ACTIVE

Required

None.

To change or track the history of a business' status, use the /businesstransitions endpoint. For more information on status changes, see Create Business Transition.

For information on configuring the required fields for KYC verification, see Perform KYC.

Request body
Fields Description

account_holder_group_token

string
Optional

Associates the specified account holder group with the business.

Allowable Values:

36 char max

Existing account holder group token

Send a GET request to /accountholdergroups to retrieve account holder group tokens

active

boolean
Optional

A value of true indicates that the business is in the ACTIVE state on the Marqeta platform.

Allowable Values:

true, false

Default value: true

attestation_consent

boolean
Optional

A value of true indicates that the attester agrees that the information provided is correct and truthful.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

true, false

attestation_date

datetime
Optional

The timestamp of the attestation.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

Format: yyyy-MM-dd or yyyy-MM-ddTHH:mm:ssZ

attester_name

string
Optional

The name of the attester for KYC verification.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

64 char max

attester_title

string
Optional

The title of the attester for KYC verification.

Allowable Values:

64 char max

beneficial_owner1

object
Optional

Contains information about the beneficial owner of the business, if applicable.

This object is required for KYC verification in the United States if the business has a beneficial owner. Do not include information about the proprietor or business officer in a beneficial_owner object. If the proprietor or officer of the business is also a beneficial owner, you must indicate that in the proprietor_is_beneficial_owner field in the body field details of the business.

Allowable Values:

Valid beneficial_owner object

beneficial_owner1.dob

datetime
Optional

Date of birth of the beneficial owner.

Allowable Values:

Format: yyyy-MM-dd

beneficial_owner1.first_name

string
Optional

First name of the beneficial owner.

Allowable Values:

2–36 chars for KYC verification (US-based accounts only); 255 char max otherwise

beneficial_owner1.home

object
Optional

An address associated with the business.

Allowable Values:

Valid address information

beneficial_owner1.home.address1

string
Optional

Street address of the business proprietor or officer.

This field is required for KYC verification (US-based accounts only). Cannot perform KYC if set to a PO Box.

Allowable Values:

35 char max

beneficial_owner1.home.address2

string
Optional

Additional address information.

Allowable Values:

35 char max

beneficial_owner1.home.city

string
Optional

City of business proprietor or officer.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

35 char max

beneficial_owner1.home.country

string
Optional

Country where the business proprietor or officer resides.

Allowable Values:

40 char max

ISO alpha-2 country code required for KYC verification (US, for example); 40 char max otherwise

beneficial_owner1.home.postal_code

string
Optional

Business proprietor or officer’s postal code.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

20 char max

beneficial_owner1.home.state

string
Optional

State where the business proprietor or officer resides.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

35 char max

Valid two-letter abbreviation required for KYC verification (CA, for example); Must be uppercase

beneficial_owner1.home.zip

string
Optional

ZIP code of the address.

Allowable Values:

20 char max

beneficial_owner1.last_name

string
Optional

Last name of the beneficial owner.

Allowable Values:

2–48 chars for KYC verification (US-based accounts only); 255 char max otherwise

beneficial_owner1.middle_name

string
Optional

Middle name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner1.phone

string
Optional

Ten-digit phone number of the beneficial owner.

Allowable Values:

Format: 510-555-1212 or 5105551212

beneficial_owner1.ssn

string
Optional

Nine-digit Social Security Number (SSN) of the beneficial owner.

Allowable Values:

Digits only, do not use separators (123456789, for example)

beneficial_owner1.title

string
Optional

Title of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner2

object
Optional

Contains information about the beneficial owner of the business, if applicable.

This object is required for KYC verification in the United States if the business has a beneficial owner. Do not include information about the proprietor or business officer in a beneficial_owner object. If the proprietor or officer of the business is also a beneficial owner, you must indicate that in the proprietor_is_beneficial_owner field in the body field details of the business.

Allowable Values:

Valid beneficial_owner object

beneficial_owner2.dob

datetime
Optional

Date of birth of the beneficial owner.

Allowable Values:

Format: yyyy-MM-dd

beneficial_owner2.first_name

string
Optional

First name of the beneficial owner.

Allowable Values:

2–36 chars for KYC verification (US-based accounts only); 255 char max otherwise

beneficial_owner2.home

object
Optional

An address associated with the business.

Allowable Values:

Valid address information

beneficial_owner2.home.address1

string
Optional

Street address of the business proprietor or officer.

This field is required for KYC verification (US-based accounts only). Cannot perform KYC if set to a PO Box.

Allowable Values:

35 char max

beneficial_owner2.home.address2

string
Optional

Additional address information.

Allowable Values:

35 char max

beneficial_owner2.home.city

string
Optional

City of business proprietor or officer.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

35 char max

beneficial_owner2.home.country

string
Optional

Country where the business proprietor or officer resides.

Allowable Values:

40 char max

ISO alpha-2 country code required for KYC verification (US, for example); 40 char max otherwise

beneficial_owner2.home.postal_code

string
Optional

Business proprietor or officer’s postal code.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

20 char max

beneficial_owner2.home.state

string
Optional

State where the business proprietor or officer resides.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

35 char max

Valid two-letter abbreviation required for KYC verification (CA, for example); Must be uppercase

beneficial_owner2.home.zip

string
Optional

ZIP code of the address.

Allowable Values:

20 char max

beneficial_owner2.last_name

string
Optional

Last name of the beneficial owner.

Allowable Values:

2–48 chars for KYC verification (US-based accounts only); 255 char max otherwise

beneficial_owner2.middle_name

string
Optional

Middle name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner2.phone

string
Optional

Ten-digit phone number of the beneficial owner.

Allowable Values:

Format: 510-555-1212 or 5105551212

beneficial_owner2.ssn

string
Optional

Nine-digit Social Security Number (SSN) of the beneficial owner.

Allowable Values:

Digits only, do not use separators (123456789, for example)

beneficial_owner2.title

string
Optional

Title of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner3

object
Optional

Contains information about the beneficial owner of the business, if applicable.

This object is required for KYC verification in the United States if the business has a beneficial owner. Do not include information about the proprietor or business officer in a beneficial_owner object. If the proprietor or officer of the business is also a beneficial owner, you must indicate that in the proprietor_is_beneficial_owner field in the body field details of the business.

Allowable Values:

Valid beneficial_owner object

beneficial_owner3.dob

datetime
Optional

Date of birth of the beneficial owner.

Allowable Values:

Format: yyyy-MM-dd

beneficial_owner3.first_name

string
Optional

First name of the beneficial owner.

Allowable Values:

2–36 chars for KYC verification (US-based accounts only); 255 char max otherwise

beneficial_owner3.home

object
Optional

An address associated with the business.

Allowable Values:

Valid address information

beneficial_owner3.home.address1

string
Optional

Street address of the business proprietor or officer.

This field is required for KYC verification (US-based accounts only). Cannot perform KYC if set to a PO Box.

Allowable Values:

35 char max

beneficial_owner3.home.address2

string
Optional

Additional address information.

Allowable Values:

35 char max

beneficial_owner3.home.city

string
Optional

City of business proprietor or officer.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

35 char max

beneficial_owner3.home.country

string
Optional

Country where the business proprietor or officer resides.

Allowable Values:

40 char max

ISO alpha-2 country code required for KYC verification (US, for example); 40 char max otherwise

beneficial_owner3.home.postal_code

string
Optional

Business proprietor or officer’s postal code.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

20 char max

beneficial_owner3.home.state

string
Optional

State where the business proprietor or officer resides.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

35 char max

Valid two-letter abbreviation required for KYC verification (CA, for example); Must be uppercase

beneficial_owner3.home.zip

string
Optional

ZIP code of the address.

Allowable Values:

20 char max

beneficial_owner3.last_name

string
Optional

Last name of the beneficial owner.

Allowable Values:

2–48 chars for KYC verification (US-based accounts only); 255 char max otherwise

beneficial_owner3.middle_name

string
Optional

Middle name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner3.phone

string
Optional

Ten-digit phone number of the beneficial owner.

Allowable Values:

Format: 510-555-1212 or 5105551212

beneficial_owner3.ssn

string
Optional

Nine-digit Social Security Number of the beneficial owner.

Allowable Values:

Digits only, do not use separators (123456789, for example)

beneficial_owner3.title

string
Optional

Title of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner4

object
Optional

Contains information about the beneficial owner of the business, if applicable.

This object is required for KYC verification in the United States if the business has a beneficial owner. Do not include information about the proprietor or business officer in a beneficial_owner object. If the proprietor or officer of the business is also a beneficial owner, you must indicate that in the proprietor_is_beneficial_owner field in the body field details of the business.

Allowable Values:

Valid beneficial_owner object

beneficial_owner4.dob

datetime
Optional

Date of birth of the beneficial owner.

Allowable Values:

Format: yyyy-MM-dd

beneficial_owner4.first_name

string
Optional

First name of the beneficial owner.

Allowable Values:

2–36 chars for KYC verification (US-based accounts only); 255 char max otherwise

beneficial_owner4.home

object
Optional

An address associated with the business.

Allowable Values:

Valid address information

beneficial_owner4.home.address1

string
Optional

Street address of the business proprietor or officer.

This field is required for KYC verification (US-based accounts only). Cannot perform KYC if set to a PO Box.

Allowable Values:

35 char max

beneficial_owner4.home.address2

string
Optional

Additional address information.

Allowable Values:

35 char max

beneficial_owner4.home.city

string
Optional

City of business proprietor or officer.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

35 char max

beneficial_owner4.home.country

string
Optional

Country where the business proprietor or officer resides.

Allowable Values:

40 char max

ISO alpha-2 country code required for KYC verification (US, for example); 40 char max otherwise

beneficial_owner4.home.postal_code

string
Optional

Business proprietor or officer’s postal code.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

20 char max

beneficial_owner4.home.state

string
Optional

State where the business proprietor or officer resides.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

35 char max

Valid two-letter abbreviation required for KYC verification (CA, for example); Must be uppercase

beneficial_owner4.home.zip

string
Optional

ZIP code of the address.

Allowable Values:

20 char max

beneficial_owner4.last_name

string
Optional

Last name of the beneficial owner.

Allowable Values:

2–48 chars for KYC verification (US-based accounts only); 255 char max otherwise

beneficial_owner4.middle_name

string
Optional

Middle name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner4.phone

string
Optional

Ten-digit phone number of the beneficial owner.

Allowable Values:

Format: 510-555-1212 or 5105551212

beneficial_owner4.ssn

string
Optional

Nine-digit Social Security Number (SSN) of the beneficial owner.

Allowable Values:

Digits only, do not use separators (123456789, for example)

beneficial_owner4.title

string
Optional

Title of the beneficial owner.

Allowable Values:

255 char max

business_name_dba

string
Optional

Fictitious business name or "Doing Business As" (DBA).

This field is required for KYC verification (US-based accounts only). If your business does not use a fictitious business name, enter your legal business name again in this field.

Allowable Values:

255 char max

128 char max for KYC verification; 255 char max otherwise

business_name_legal

string
Optional

Legal name of business.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

255 char max

128 char max for KYC verification; 255 char max otherwise

business_type

string
Optional

Indicates the type of business (B2B [business-to-business] or B2C [business-to-consumer], for example).

Allowable Values:

255 char max

date_established

datetime
Optional

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
Optional

Data Universal Numbering System (DUNS) number of the business.

Allowable Values:

255 char max

general_business_description

string
Optional

General description of the business.

Allowable Values:

255 char max

history

string
Optional

History of the business.

Allowable Values:

255 char max

identifications

array of objects
Optional

One or more objects containing identifications associated with the business.

Allowable Values:

Valid identifications array

identifications[].expiration_date

string
Optional

Expiration date for the form of identification, if applicable.

Allowable Values:

Format: yyyy-MM-dd

identifications[].type

string
Required

Form of identification.

BUSINESS_TAX_ID is required for KYC verification (US-based accounts only).

Allowable Values:

SSN, TIN, SIN, NIN, PASSPORT_NUMBER, DRIVERS_LICENSE, BUSINESS_NUMBER, BUSINESS_TAX_ID, TAXPAYER_REFERENCE

identifications[].value

string
Optional

Identification number.

Allowable Values:

255 char max

Nine-digit identification number with no delimiters required for KYC verification (US-based accounts only). For example: 123456789

in_current_location_since

datetime
Optional

The date on which the business office opened in its current location.

Allowable Values:

Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ssZ

incorporation

object
Optional

Contains information about the organizational structure of the business.

This object is required for KYC verification (US-based accounts only).

Allowable Values:

Valid incorporation object

incorporation.address_registered_under

object
Optional

An address associated with the business.

Allowable Values:

Valid address information

incorporation.address_registered_under.address1

string
Optional

Street address of the business proprietor or officer.

This field is required for KYC verification (US-based accounts only). Cannot perform KYC if set to a PO Box.

Allowable Values:

35 char max

incorporation.address_registered_under.address2

string
Optional

Additional address information.

Allowable Values:

35 char max

incorporation.address_registered_under.city

string
Optional

City of business proprietor or officer.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

35 char max

incorporation.address_registered_under.country

string
Optional

Country where the business proprietor or officer resides.

Allowable Values:

40 char max

ISO alpha-2 country code required for KYC verification (US, for example); 40 char max otherwise

incorporation.address_registered_under.postal_code

string
Optional

Business proprietor or officer’s postal code.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

20 char max

incorporation.address_registered_under.state

string
Optional

State where the business proprietor or officer resides.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

35 char max

Valid two-letter abbreviation required for KYC verification (CA, for example); Must be uppercase

incorporation.address_registered_under.zip

string
Optional

ZIP code of the address.

Allowable Values:

20 char max

incorporation.incorporation_type

string
Optional

Organizational structure of the business, such as corporation or sole proprietorship.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

LLC, CORPORATION, SOLE_PROPRIETORSHIP, PARTNERSHIP, COOPERATIVE, OTHER

incorporation.is_public

boolean
Optional

A value of true indicates that the business is publicly held.

Allowable Values:

true, false

Default value:
false

incorporation.name_registered_under

string
Optional

Name under which the business is registered.

Allowable Values:

255 char max

incorporation.state_of_incorporation

string
Optional

State 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 (CA, for example); 255 char max otherwise.

incorporation.stock_symbol

string
Optional

Business stock symbol.

Allowable Values:

255 char max

international_office_locations

string
Optional

The locations of the business' offices outside the US.

Allowable Values:

255 char max

ip_address

string
Optional

The IP address of the business.

Allowable Values:

39 char max

metadata

object
Optional

Associates any additional metadata you provide with the business.

Allowable Values:

You can define the names and values of up to 20 fields in the format "my_name_1": "my_value_1".

notes

string
Optional

Any additional information pertaining to the business.

Allowable Values:

255 char max

office_location

object
Optional

An address associated with the business.

Allowable Values:

Valid address information

office_location.address1

string
Optional

Street address of the business proprietor or officer.

This field is required for KYC verification (US-based accounts only). Cannot perform KYC if set to a PO Box.

Allowable Values:

35 char max

office_location.address2

string
Optional

Additional address information.

Allowable Values:

35 char max

office_location.city

string
Optional

City of business proprietor or officer.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

35 char max

office_location.country

string
Optional

Country where the business proprietor or officer resides.

Allowable Values:

40 char max

ISO alpha-2 country code required for KYC verification (US, for example); 40 char max otherwise

office_location.postal_code

string
Optional

Business proprietor or officer’s postal code.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

20 char max

office_location.state

string
Optional

State where the business proprietor or officer resides.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

35 char max

Valid two-letter abbreviation required for KYC verification (CA, for example); Must be uppercase

office_location.zip

string
Optional

ZIP code of the address.

Allowable Values:

20 char max

password

string
Optional

Password for the business account on the Marqeta platform.

Allowable Values:

1–255 chars

  • Must contain at least one numeral

  • Must contain at least one lowercase letter

  • Must contain at least one uppercase letter

  • Must contain at least one of these symbols: @ # $ % ! ^ & * ( ) \ _ + ~ ` - = [ ] { } , ; : ' " , . / < > ?

phone

string
Optional

10-digit telephone number of business.

Allowable Values:

255 char max

Format: 510-555-1212 or 5105551212

primary_contact

object
Optional

Describes the business' primary contact person.

Allowable Values:

Valid primary_contact object

primary_contact.department

string
Optional

Business department of the primary contact.

Allowable Values:

255 char max

primary_contact.email

string
Optional

Email address of the primary contact.

Allowable Values:

255 char max

primary_contact.extension

string
Optional

Phone extension of the primary contact.

Allowable Values:

255 char max

primary_contact.fax

string
Optional

Fax number of the primary contact.

Allowable Values:

255 char max

Format: 510-555-1212 or 5105551212

primary_contact.full_name

string
Optional

Full name of the primary contact.

Allowable Values:

255 char max

primary_contact.mobile

string
Optional

Mobile phone number of the primary contact.

Allowable Values:

255 char max

Format: 510-555-1212 or 5105551212

primary_contact.phone

string
Optional

Phone number of the primary contact.

Allowable Values:

255 char max

Format: 510-555-1212 or 5105551212

primary_contact.title

string
Optional

Title of the primary contact.

Allowable Values:

255 char max

proprietor_is_beneficial_owner

boolean
Optional

A value of true indicates that the proprietor or officer of the business is also a beneficial owner.

This field is required for KYC verification if the business proprietor or officer is also a beneficial owner.

Allowable Values:

true, false

Default value:
false

proprietor_or_officer

object
Optional

Contains information about the proprietor or officer of the business.

This object is required for KYC verification in the United States.

Allowable Values:

A valid proprietor_or_officer object

proprietor_or_officer.alternative_names

string
Optional

Alternate names of the business proprietor or officer.

Allowable Values:

255 char max

proprietor_or_officer.dob

datetime
Optional

Business proprietor or officer’s date of birth.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

Format: yyyy-MM-dd or yyyy-MM-ddTHH:mm:ssZ

proprietor_or_officer.email

string
Optional

Email address of the business proprietor or officer.

Allowable Values:

255 char max

proprietor_or_officer.first_name

string
Required

First name of business proprietor or officer.

Allowable Values:

2–36 chars for KYC verification (US-based accounts only); 255 char max otherwise

proprietor_or_officer.home

object
Optional

An address associated with the business.

Allowable Values:

Valid address information

proprietor_or_officer.home.address1

string
Optional

Street address of the business proprietor or officer.

This field is required for KYC verification (US-based accounts only). Cannot perform KYC if set to a PO Box.

Allowable Values:

35 char max

proprietor_or_officer.home.address2

string
Optional

Additional address information.

Allowable Values:

35 char max

proprietor_or_officer.home.city

string
Optional

City of business proprietor or officer.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

35 char max

proprietor_or_officer.home.country

string
Optional

Country where the business proprietor or officer resides.

Allowable Values:

40 char max

ISO alpha-2 country code required for KYC verification (US, for example); 40 char max otherwise

proprietor_or_officer.home.postal_code

string
Optional

Business proprietor or officer’s postal code.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

20 char max

proprietor_or_officer.home.state

string
Optional

State where the business proprietor or officer resides.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

35 char max

Valid two-letter abbreviation required for KYC verification (CA, for example); Must be uppercase

proprietor_or_officer.home.zip

string
Optional

ZIP code of the address.

Allowable Values:

20 char max

proprietor_or_officer.identifications

array of objects
Optional

One or more objects containing personal identifications of the business proprietor or officer.

Allowable Values:

Valid identifications array

proprietor_or_officer.identifications[].expiration_date

string
Optional

Expiration date for the form of identification, if applicable.

Allowable Values:

Format: yyyy-MM-dd

proprietor_or_officer.identifications[].type

string
Required

Form of identification.

BUSINESS_TAX_ID is required for KYC verification (US-based accounts only).

Allowable Values:

SSN, TIN, SIN, NIN, PASSPORT_NUMBER, DRIVERS_LICENSE, BUSINESS_NUMBER, BUSINESS_TAX_ID, TAXPAYER_REFERENCE

proprietor_or_officer.identifications[].value

string
Optional

Identification number.

Allowable Values:

255 char max

Nine-digit identification number with no delimiters required for KYC verification (US-based accounts only). For example: 123456789

proprietor_or_officer.last_name

string
Required

Last name of business proprietor or officer.

Allowable Values:

2–48 chars for KYC verification (US-based accounts only); 255 char max otherwise

proprietor_or_officer.middle_name

string
Optional

Middle name of business proprietor or officer.

Allowable Values:

255 char max

proprietor_or_officer.phone

string
Optional

Telephone number of the business proprietor or officer.

Allowable Values:

Format: 510-555-1212 or 5105551212

Do not insert a 1 before the area code

proprietor_or_officer.ssn

string
Optional

The Social Security Number of the business proprietor or officer.

Allowable Values:

Nine digits, no delimiters (123456789, for example)

proprietor_or_officer.title

string
Optional

Title of business proprietor or officer.

Allowable Values:

255 char max

taxpayer_id

string
Optional

The taxpayer identifier of the business.

Allowable Values:

255 char max

token

string
Optional

The unique identifier of the business resource.

If you do not include a token, the system generates one automatically. This token is necessary for use in other API calls, so we recommend that rather than let the system generate one, you use a simple string that is easy to remember. This value cannot be updated.

Allowable Values:

1–36 chars

website

string
Optional

URL of the business' website.

Allowable Values:

255 char max

Sample request body
JSON
Copied

Is this helpful?

Yes
No
Response body
Fields Description

account_holder_group_token

string
Conditionally returned

Associates the specified account holder group with the business.

Allowable Values:

36 char max

active

boolean
Conditionally returned

A value of true indicates that the business is in the ACTIVE state on the Marqeta platform.

Allowable Values:

true, false

attestation_consent

boolean
Conditionally returned

A value of true indicates that the attester agrees that the information provided is correct and truthful.

Allowable Values:

true, false

attestation_date

datetime
Conditionally returned

The timestamp of the attestation.

Allowable Values:

Format: yyyy-MM-dd or yyyy-MM-ddTHH:mm:ssZ

attester_name

string
Conditionally returned

The name of the attester for KYC verification.

Allowable Values:

64 char max

attester_title

string
Conditionally returned

The title of the attester for KYC verification.

Allowable Values:

64 char max

authentication

object
Conditionally returned

Contains email address and password information for the business resource.

Allowable Values:

Valid authentication object

authentication.email_verified

boolean
Conditionally returned

A value of true indicates that the email address has been verified.

Allowable Values:

true, false

authentication.email_verified_time

datetime
Conditionally returned

The time and date that the email address was verified.

Allowable Values:

Format: yyyy-MM-ddTHH:mm:ssZ

authentication.last_password_update_channel

string
Conditionally returned

Specifies the channel through which the password was last changed.

Allowable Values:

USER_CHANGE, USER_RESET

authentication.last_password_update_time

datetime
Conditionally returned

The time and date that the password was last changed.

Allowable Values:

Format: yyyy-MM-ddTHH:mm:ssZ

beneficial_owner1

object
Conditionally returned

Contains information about the beneficial owner of the business, if applicable.

Allowable Values:

Existing beneficial_owner object

beneficial_owner1.first_name

string
Conditionally returned

First name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner1.getdob

datetime
Conditionally returned

Date of birth of the beneficial owner.

Allowable Values:

Format: yyyy-MM-dd

beneficial_owner1.home

object
Conditionally returned

The home address of the beneficial owner.

Allowable Values:

Existing home object

beneficial_owner1.home.address1

string
Conditionally returned

Street address.

Allowable Values:

35 char max

beneficial_owner1.home.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

beneficial_owner1.home.city

string
Conditionally returned

City.

Allowable Values:

35 char max

beneficial_owner1.home.country

string
Conditionally returned

Country.

Allowable Values:

40 char max

beneficial_owner1.home.postal_code

string
Conditionally returned

Postal code of the address.

Allowable Values:

20 char max

beneficial_owner1.home.state

string
Conditionally returned

State, province, or territory of the address.

Allowable Values:

35 char max

beneficial_owner1.home.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

beneficial_owner1.last_name

string
Conditionally returned

Last name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner1.middle_name

string
Conditionally returned

Middle name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner1.phone

string
Conditionally returned

Ten-digit phone number of the beneficial owner.

Allowable Values:

Format: 510-555-1212 or 5105551212

beneficial_owner1.title

string
Conditionally returned

Title of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner2

object
Conditionally returned

Contains information about the beneficial owner of the business, if applicable.

Allowable Values:

Existing beneficial_owner object

beneficial_owner2.first_name

string
Conditionally returned

First name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner2.getdob

datetime
Conditionally returned

Date of birth of the beneficial owner.

Allowable Values:

Format: yyyy-MM-dd

beneficial_owner2.home

object
Conditionally returned

The home address of the beneficial owner.

Allowable Values:

Existing home object

beneficial_owner2.home.address1

string
Conditionally returned

Street address.

Allowable Values:

35 char max

beneficial_owner2.home.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

beneficial_owner2.home.city

string
Conditionally returned

City.

Allowable Values:

35 char max

beneficial_owner2.home.country

string
Conditionally returned

Country.

Allowable Values:

40 char max

beneficial_owner2.home.postal_code

string
Conditionally returned

Postal code of the address.

Allowable Values:

20 char max

beneficial_owner2.home.state

string
Conditionally returned

State, province, or territory of the address.

Allowable Values:

35 char max

beneficial_owner2.home.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

beneficial_owner2.last_name

string
Conditionally returned

Last name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner2.middle_name

string
Conditionally returned

Middle name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner2.phone

string
Conditionally returned

Ten-digit phone number of the beneficial owner.

Allowable Values:

Format: 510-555-1212 or 5105551212

beneficial_owner2.title

string
Conditionally returned

Title of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner3

object
Conditionally returned

Contains information about the beneficial owner of the business, if applicable.

Allowable Values:

Existing beneficial_owner object

beneficial_owner3.first_name

string
Conditionally returned

First name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner3.getdob

datetime
Conditionally returned

Date of birth of the beneficial owner.

Allowable Values:

Format: yyyy-MM-dd

beneficial_owner3.home

object
Conditionally returned

The home address of the beneficial owner.

Allowable Values:

Existing home object

beneficial_owner3.home.address1

string
Conditionally returned

Street address.

Allowable Values:

35 char max

beneficial_owner3.home.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

beneficial_owner3.home.city

string
Conditionally returned

City.

Allowable Values:

35 char max

beneficial_owner3.home.country

string
Conditionally returned

Country.

Allowable Values:

40 char max

beneficial_owner3.home.postal_code

string
Conditionally returned

Postal code of the address.

Allowable Values:

20 char max

beneficial_owner3.home.state

string
Conditionally returned

State, province, or territory of the address.

Allowable Values:

35 char max

beneficial_owner3.home.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

beneficial_owner3.last_name

string
Conditionally returned

Last name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner3.middle_name

string
Conditionally returned

Middle name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner3.phone

string
Conditionally returned

Ten-digit phone number of the beneficial owner.

Allowable Values:

Format: 510-555-1212 or 5105551212

beneficial_owner3.title

string
Conditionally returned

Title of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner4

object
Conditionally returned

Contains information about the beneficial owner of the business, if applicable.

Allowable Values:

Existing beneficial_owner object

beneficial_owner4.first_name

string
Conditionally returned

First name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner4.getdob

datetime
Conditionally returned

Date of birth of the beneficial owner.

Allowable Values:

Format: yyyy-MM-dd

beneficial_owner4.home

object
Conditionally returned

The home address of the beneficial owner.

Allowable Values:

Existing home object

beneficial_owner4.home.address1

string
Conditionally returned

Street address.

Allowable Values:

35 char max

beneficial_owner4.home.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

beneficial_owner4.home.city

string
Conditionally returned

City.

Allowable Values:

35 char max

beneficial_owner4.home.country

string
Conditionally returned

Country.

Allowable Values:

40 char max

beneficial_owner4.home.postal_code

string
Conditionally returned

Postal code of the address.

Allowable Values:

20 char max

beneficial_owner4.home.state

string
Conditionally returned

State, province, or territory of the address.

Allowable Values:

35 char max

beneficial_owner4.home.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

beneficial_owner4.last_name

string
Conditionally returned

Last name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner4.middle_name

string
Conditionally returned

Middle name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner4.phone

string
Conditionally returned

Ten-digit phone number of the beneficial owner.

Allowable Values:

Format: 510-555-1212 or 5105551212

beneficial_owner4.title

string
Conditionally returned

Title of the beneficial owner.

Allowable Values:

255 char max

business_name_dba

string
Conditionally returned

Fictitious business name or "Doing Business As" (DBA).

Allowable Values:

255 char max

business_name_legal

string
Conditionally returned

Legal name of business.

Allowable Values:

255 char max

business_type

string
Conditionally returned

Indicates the type of business (B2B [business-to-business] or B2C [business-to-consumer], for example).

Allowable Values:

255 char max

created_time

datetime
Returned

The date and time when the business was created, in UTC (2021-10-26T20:03:05Z, for example.)

Allowable Values:

Format: yyyy-MM-ddThh:mm:ssZ

date_established

datetime
Conditionally returned

The date and time when the business was established.

Allowable Values:

Format: yyyy-MM-dd or yyyy-MM-ddTHH:mm:ssZ

duns_number

string
Conditionally returned

Data Universal Numbering System (DUNS) number of the business.

Allowable Values:

255 char max

general_business_description

string
Conditionally returned

General description of the business.

Allowable Values:

255 char max

history

string
Conditionally returned

History of the business.

Allowable Values:

255 char max

identifications

array of objects
Conditionally returned

One or more objects containing identifications associated with the business.

Allowable Values:

Existing identifications array

identifications[].expiration_date

string
Conditionally returned

Expiration date for the form of identification, if applicable.

Allowable Values:

Format: yyyy-MM-dd

identifications[].type

string
Conditionally returned

The form of identification.

Allowable Values:

SSN, TIN, SIN, NIN, PASSPORT_NUMBER, DRIVERS_LICENSE, BUSINESS_NUMBER, BUSINESS_TAX_ID, TAXPAYER_REFERENCE

identifications[].value

string
Conditionally returned

Identification number associated with the form of identification.

Allowable Values:

255 char max

in_current_location_since

datetime
Conditionally returned

The date on which the business office opened in its current location.

Allowable Values:

Format: yyyy-MM-dd or yyyy-MM-ddTHH:mm:ssZ

incorporation

object
Conditionally returned

Contains information about the organizational structure of the business.

Allowable Values:

Existing incorporation object

incorporation.address_registered_under

object
Conditionally returned

The registered business address.

Allowable Values:

Existing address_registered_under object

incorporation.address_registered_under.address1

string
Conditionally returned

Street address.

Allowable Values:

35 char max

incorporation.address_registered_under.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

incorporation.address_registered_under.city

string
Conditionally returned

City.

Allowable Values:

35 char max

incorporation.address_registered_under.country

string
Conditionally returned

Country.

Allowable Values:

40 char max

incorporation.address_registered_under.postal_code

string
Conditionally returned

Postal code of the address.

Allowable Values:

20 char max

incorporation.address_registered_under.state

string
Conditionally returned

State, province, or territory of the address.

Allowable Values:

35 char max

incorporation.address_registered_under.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

incorporation.incorporation_type

string
Conditionally returned

Organizational structure of the business (corporation or sole proprietorship, for example).

Allowable Values:

LLC, CORPORATION, SOLE_PROPRIETORSHIP, PARTNERSHIP, OTHER

incorporation.is_public

boolean
Conditionally returned

A value of true indicates that the business is publicly held.

Allowable Values:

true, false

incorporation.name_registered_under

string
Conditionally returned

Name under which the business is registered.

Allowable Values:

255 char max

incorporation.state_of_incorporation

string
Conditionally returned

State where the business is incorporated.

Allowable Values:

255 char max

incorporation.stock_symbol

string
Conditionally returned

Stock symbol associated with the business.

Allowable Values:

255 char max

international_office_locations

string
Conditionally returned

The locations of the business' offices outside the US.

Allowable Values:

255 char max

ip_address

string
Conditionally returned

The IP address of the business.

Allowable Values:

39 char max

last_modified_time

datetime
Returned

The date and time when the business was last modified, in UTC. 2021-10-26T20:03:05Z, for example.

Allowable Values:

Format: yyyy-MM-ddThh:mm:ssZ

metadata

object
Conditionally returned

Associates any additional metadata you provide with the business.

Allowable Values:

Existing metadata object

notes

string
Conditionally returned

Any additional information pertaining to the business.

Allowable Values:

255 char max

office_location

object
Conditionally returned

The address of the business office.

Allowable Values:

Existing office_location object

office_location.address1

string
Conditionally returned

Street address.

Allowable Values:

35 char max

office_location.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

office_location.city

string
Conditionally returned

City.

Allowable Values:

35 char max

office_location.country

string
Conditionally returned

Country.

Allowable Values:

40 char max

office_location.postal_code

string
Conditionally returned

Postal code of the address.

Allowable Values:

20 char max

office_location.state

string
Conditionally returned

State, province, or territory of the address.

Allowable Values:

35 char max

office_location.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

password

string
Conditionally returned

Password for the business account on the Marqeta platform.

Allowable Values:

1–255 chars

phone

string
Conditionally returned

10-digit telephone number of business.

Allowable Values:

255 char max

primary_contact

object
Conditionally returned

Describes the business' primary contact person.

Allowable Values:

Valid primary_contact object

primary_contact.department

string
Conditionally returned

Business department of the primary contact.

Allowable Values:

255 char max

primary_contact.email

string
Conditionally returned

Email address of the primary contact.

Allowable Values:

255 char max

primary_contact.extension

string
Conditionally returned

Phone extension of the primary contact.

Allowable Values:

255 char max

primary_contact.fax

string
Conditionally returned

Fax number of the primary contact.

Allowable Values:

255 char max

Format: 510-555-1212 or 5105551212

primary_contact.full_name

string
Conditionally returned

Full name of the primary contact.

Allowable Values:

255 char max

primary_contact.mobile

string
Conditionally returned

Mobile phone number of the primary contact.

Allowable Values:

255 char max

Format: 510-555-1212 or 5105551212

primary_contact.phone

string
Conditionally returned

Phone number of the primary contact.

Allowable Values:

255 char max

Format: 510-555-1212 or 5105551212

primary_contact.title

string
Conditionally returned

Title of the primary contact.

Allowable Values:

255 char max

proprietor_is_beneficial_owner

boolean
Conditionally returned

A value of true indicates that the proprietor or officer of the business is also a beneficial owner.

Allowable Values:

true, false

proprietor_or_officer

object
Conditionally returned

Contains information about the proprietor or officer of the business.

Allowable Values:

Existing proprietor_or_officer object

proprietor_or_officer.alternative_names

string
Conditionally returned

Alternate names of the business proprietor or officer.

Allowable Values:

255 char max

proprietor_or_officer.dob

datetime
Conditionally returned

Business proprietor or officer’s date of birth.

Allowable Values:

Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ssZ

proprietor_or_officer.email

string
Conditionally returned

Email address of the business proprietor or officer.

Allowable Values:

255 char max

proprietor_or_officer.first_name

string
Conditionally returned

First name of the business proprietor or officer.

Allowable Values:

255 char max

proprietor_or_officer.home

object
Conditionally returned

The home address of the proprietor or officer.

Allowable Values:

Existing home object

proprietor_or_officer.home.address1

string
Conditionally returned

Street address.

Allowable Values:

35 char max

proprietor_or_officer.home.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

proprietor_or_officer.home.city

string
Conditionally returned

City.

Allowable Values:

35 char max

proprietor_or_officer.home.country

string
Conditionally returned

Country.

Allowable Values:

40 char max

proprietor_or_officer.home.postal_code

string
Conditionally returned

Postal code of the address.

Allowable Values:

20 char max

proprietor_or_officer.home.state

string
Conditionally returned

State, province, or territory of the address.

Allowable Values:

35 char max

proprietor_or_officer.home.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

proprietor_or_officer.identifications

array of objects
Conditionally returned

One or more objects containing personal identifications of the business proprietor or officer.

Allowable Values:

Existing identifications array

proprietor_or_officer.identifications[].expiration_date

string
Conditionally returned

Expiration date for the form of identification, if applicable.

Allowable Values:

Format: yyyy-MM-dd

proprietor_or_officer.identifications[].type

string
Conditionally returned

The form of identification.

Allowable Values:

SSN, TIN, SIN, NIN, PASSPORT_NUMBER, DRIVERS_LICENSE, BUSINESS_NUMBER, BUSINESS_TAX_ID, TAXPAYER_REFERENCE

proprietor_or_officer.identifications[].value

string
Conditionally returned

Identification number associated with the form of identification.

Allowable Values:

255 char max

proprietor_or_officer.last_name

string
Conditionally returned

Last name of the business proprietor or officer.

Allowable Values:

255 char max

proprietor_or_officer.middle_name

string
Conditionally returned

Middle name of the business proprietor or officer.

Allowable Values:

255 char max

proprietor_or_officer.phone

string
Conditionally returned

Telephone number of the business proprietor or officer.

Allowable Values:

Format: 510-555-1212 or 5105551212

proprietor_or_officer.ssn

string
Conditionally returned

Social Security Number of the business proprietor or officer.

Allowable Values:

9 char max

proprietor_or_officer.title

string
Conditionally returned

Title of the business proprietor or officer.

Allowable Values:

255 char max

status

string
Conditionally returned

Specifies the state of the business on the Marqeta platform.

Allowable Values:

UNVERIFIED, LIMITED, ACTIVE, SUSPENDED, CLOSED

taxpayer_id

string
Conditionally returned

The taxpayer identifier of the business.

Allowable Values:

255 char max

token

string
Conditionally returned

The unique identifier of the business resource.

Allowable Values:

1–36 chars

website

string
Conditionally returned

URL of the business' website.

Allowable Values:

255 char max

Sample response body
JSON
Copied

Is this helpful?

Yes
No

List businesses

Action: GET
Endpoint: /businesses

Return an array of all businesses.

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
Fields Description

count

integer
Optional

The number of business resources to retrieve.

Allowable Values:

1-10

start_index

integer
Optional

The sort order index of the first resource in the returned array.

Allowable Values:

Any integer

business_name_dba

string
Optional

The fictitious or "doing business as" (DBA) name of the business.

Allowable Values:

Existing DBA name of the business

business_name_legal

string
Optional

The legal name of the business.

Allowable Values:

Existing legal name of the business

search_type

string
Optional

Specifies the search type for the query.

Allowable Values:

query_then_fetch, dfs_query_then_fetch

fields

string
Optional

Comma-delimited list of fields to return (field_1,field_2, and so on). Leave blank to return all fields.

Allowable Values:

Comma-delimited list of fields, or blank

sort_by

string
Optional

Field on which to sort. Use any field in the resource model, or one of the system fields lastModifiedTime or createdTime. Prefix the field name with a hyphen (-) to sort in descending order. Omit the hyphen to sort in ascending order.

Allowable Values:

lastModifiedTime, createdTime, or any field in the resource model

Response body
Fields Description

count

integer
Conditionally returned

The number of resources to retrieve.

Allowable Values:

1-10

data

array of objects
Conditionally returned

An array of business objects.

Allowable Values:

Valid data array

data[].account_holder_group_token

string
Conditionally returned

Associates the specified account holder group with the business.

Allowable Values:

36 char max

data[].active

boolean
Conditionally returned

A value of true indicates that the business is in the ACTIVE state on the Marqeta platform.

Allowable Values:

true, false

data[].attestation_consent

boolean
Conditionally returned

A value of true indicates that the attester agrees that the information provided is correct and truthful.

Allowable Values:

true, false

data[].attestation_date

datetime
Conditionally returned

The timestamp of the attestation.

Allowable Values:

Format: yyyy-MM-dd or yyyy-MM-ddTHH:mm:ssZ

data[].attester_name

string
Conditionally returned

The name of the attester for KYC verification.

Allowable Values:

64 char max

data[].attester_title

string
Conditionally returned

The title of the attester for KYC verification.

Allowable Values:

64 char max

data[].beneficial_owner1

object
Conditionally returned

Contains information about the beneficial owner of the business, if applicable.

Allowable Values:

Valid beneficial_owner object

data[].beneficial_owner1.dob

datetime
Conditionally returned

Date of birth of the beneficial owner.

Allowable Values:

Format: yyyy-MM-dd

data[].beneficial_owner1.first_name

string
Conditionally returned

First name of the beneficial owner.

Allowable Values:

255 char max

data[].beneficial_owner1.home

object
Conditionally returned

An address associated with the business.

Allowable Values:

Valid address information

data[].beneficial_owner1.home.address1

string
Conditionally returned

Street address of the business proprietor or officer.

Allowable Values:

35 char max

data[].beneficial_owner1.home.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

data[].beneficial_owner1.home.city

string
Conditionally returned

City of business proprietor or officer.

Allowable Values:

35 char max

data[].beneficial_owner1.home.country

string
Conditionally returned

Country where the business proprietor or officer resides.

Allowable Values:

40 char max

data[].beneficial_owner1.home.postal_code

string
Conditionally returned

Business proprietor or officer’s postal code.

Allowable Values:

20 char max

data[].beneficial_owner1.home.state

string
Conditionally returned

State where the business proprietor or officer resides.

Allowable Values:

35 char max

data[].beneficial_owner1.home.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

data[].beneficial_owner1.last_name

string
Conditionally returned

Last name of the beneficial owner.

Allowable Values:

255 char max

data[].beneficial_owner1.middle_name

string
Conditionally returned

Middle name of the beneficial owner.

Allowable Values:

255 char max

data[].beneficial_owner1.phone

string
Conditionally returned

Ten-digit phone number of the beneficial owner.

Allowable Values:

Format: 510-555-1212 or 5105551212

data[].beneficial_owner1.ssn

string
Conditionally returned

Nine-digit Social Security Number (SSN) of the beneficial owner.

Allowable Values:

Digits only, do not use separators (123456789, for example)

data[].beneficial_owner1.title

string
Conditionally returned

Title of the beneficial owner.

Allowable Values:

255 char max

data[].beneficial_owner2

object
Conditionally returned

Contains information about the beneficial owner of the business, if applicable.

Allowable Values:

Valid beneficial_owner object

data[].beneficial_owner2.dob

datetime
Conditionally returned

Date of birth of the beneficial owner.

Allowable Values:

Format: yyyy-MM-dd

data[].beneficial_owner2.first_name

string
Conditionally returned

First name of the beneficial owner.

Allowable Values:

255 char max

data[].beneficial_owner2.home

object
Conditionally returned

An address associated with the business.

Allowable Values:

Valid address information

data[].beneficial_owner2.home.address1

string
Conditionally returned

Street address of the business proprietor or officer.

Allowable Values:

35 char max

data[].beneficial_owner2.home.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

data[].beneficial_owner2.home.city

string
Conditionally returned

City of business proprietor or officer.

Allowable Values:

35 char max

data[].beneficial_owner2.home.country

string
Conditionally returned

Country where the business proprietor or officer resides.

Allowable Values:

40 char max

data[].beneficial_owner2.home.postal_code

string
Conditionally returned

Business proprietor or officer’s postal code.

Allowable Values:

20 char max

data[].beneficial_owner2.home.state

string
Conditionally returned

State where the business proprietor or officer resides.

Allowable Values:

35 char max

data[].beneficial_owner2.home.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

data[].beneficial_owner2.last_name

string
Conditionally returned

Last name of the beneficial owner.

Allowable Values:

255 char max

data[].beneficial_owner2.middle_name

string
Conditionally returned

Middle name of the beneficial owner.

Allowable Values:

255 char max

data[].beneficial_owner2.phone

string
Conditionally returned

Ten-digit phone number of the beneficial owner.

Allowable Values:

Format: 510-555-1212 or 5105551212

data[].beneficial_owner2.ssn

string
Conditionally returned

Nine-digit Social Security Number (SSN) of the beneficial owner.

Allowable Values:

Digits only, do not use separators (123456789, for example)

data[].beneficial_owner2.title

string
Conditionally returned

Title of the beneficial owner.

Allowable Values:

255 char max

data[].beneficial_owner3

object
Conditionally returned

Contains information about the beneficial owner of the business, if applicable.

Allowable Values:

Valid beneficial_owner object

data[].beneficial_owner3.dob

datetime
Conditionally returned

Date of birth of the beneficial owner.

Allowable Values:

Format: yyyy-MM-dd

data[].beneficial_owner3.first_name

string
Conditionally returned

First name of the beneficial owner.

Allowable Values:

255 char max

data[].beneficial_owner3.home

object
Conditionally returned

An address associated with the business.

Allowable Values:

Valid address information

data[].beneficial_owner3.home.address1

string
Conditionally returned

Street address of the business proprietor or officer.

Allowable Values:

35 char max

data[].beneficial_owner3.home.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

data[].beneficial_owner3.home.city

string
Conditionally returned

City of business proprietor or officer.

Allowable Values:

35 char max

data[].beneficial_owner3.home.country

string
Conditionally returned

Country where the business proprietor or officer resides.

Allowable Values:

40 char max

data[].beneficial_owner3.home.postal_code

string
Conditionally returned

Business proprietor or officer’s postal code.

Allowable Values:

20 char max

data[].beneficial_owner3.home.state

string
Conditionally returned

State where the business proprietor or officer resides.

This field is required for KYC verification (US-based accounts only).

Allowable Values:

35 char max

data[].beneficial_owner3.home.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

data[].beneficial_owner3.last_name

string
Conditionally returned

Last name of the beneficial owner.

Allowable Values:

2–48 chars for KYC verification (US-based accounts only); 255 char max otherwise

data[].beneficial_owner3.middle_name

string
Conditionally returned

Middle name of the beneficial owner.

Allowable Values:

255 char max

data[].beneficial_owner3.phone

string
Conditionally returned

Ten-digit phone number of the beneficial owner.

Allowable Values:

Format: 510-555-1212 or 5105551212

data[].beneficial_owner3.ssn

string
Conditionally returned

Nine-digit Social Security Number (SSN) of the beneficial owner.

Allowable Values:

Digits only, do not use separators (123456789, for example)

data[].beneficial_owner3.title

string
Conditionally returned

Title of the beneficial owner.

Allowable Values:

255 char max

data[].beneficial_owner4

object
Conditionally returned

Contains information about the beneficial owner of the business, if applicable.

Allowable Values:

Valid beneficial_owner object

data[].beneficial_owner4.dob

datetime
Conditionally returned

Date of birth of the beneficial owner.

Allowable Values:

Format: yyyy-MM-dd

data[].beneficial_owner4.first_name

string
Conditionally returned

First name of the beneficial owner.

Allowable Values:

255 char max

data[].beneficial_owner4.home

object
Conditionally returned

An address associated with the business.

Allowable Values:

Valid address information

data[].beneficial_owner4.home.address1

string
Conditionally returned

Street address of the business proprietor or officer.

Allowable Values:

35 char max

data[].beneficial_owner4.home.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

data[].beneficial_owner4.home.city

string
Conditionally returned

City of business proprietor or officer.

Allowable Values:

35 char max

data[].beneficial_owner4.home.country

string
Conditionally returned

Country where the business proprietor or officer resides.

Allowable Values:

40 char max

data[].beneficial_owner4.home.postal_code

string
Conditionally returned

Business proprietor or officer’s postal code.

Allowable Values:

20 char max

data[].beneficial_owner4.home.state

string
Conditionally returned

State where the business proprietor or officer resides.

Allowable Values:

35 char max

data[].beneficial_owner4.home.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

data[].beneficial_owner4.last_name

string
Conditionally returned

Last name of the beneficial owner.

Allowable Values:

255 char max

data[].beneficial_owner4.middle_name

string
Conditionally returned

Middle name of the beneficial owner.

Allowable Values:

255 char max

data[].beneficial_owner4.phone

string
Conditionally returned

Ten-digit phone number of the beneficial owner.

Allowable Values:

Format: 510-555-1212 or 5105551212

data[].beneficial_owner4.ssn

string
Conditionally returned

Nine-digit Social Security Number (SSN) of the beneficial owner.

Allowable Values:

Digits only, do not use separators (123456789, for example)

data[].beneficial_owner4.title

string
Conditionally returned

Title of the beneficial owner.

Allowable Values:

255 char max

data[].business_name_dba

string
Conditionally returned

Fictitious business name or "Doing Business As" (DBA).

Allowable Values:

255 char max

data[].business_name_legal

string
Conditionally returned

Legal name of business.

Allowable Values:

255 char max

data[].business_type

string
Conditionally returned

Indicates the type of business (B2B [business-to-business] or B2C [business-to-consumer], for example).

Allowable Values:

255 char max

data[].date_established

datetime
Conditionally returned

Date the business was established.

Allowable Values:

Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ssZ

data[].duns_number

string
Conditionally returned

Data Universal Numbering System (DUNS) number of the business.

Allowable Values:

255 char max

data[].general_business_description

string
Conditionally returned

General description of the business.

Allowable Values:

255 char max

data[].history

string
Conditionally returned

History of the business.

Allowable Values:

255 char max

data[].identifications

array of objects
Conditionally returned

One or more objects containing identifications associated with the business.

Allowable Values:

Valid identifications array

data[].identifications[].expiration_date

string
Conditionally returned

Expiration date for the form of identification, if applicable.

Allowable Values:

Format: yyyy-MM-dd

data[].identifications[].type

string
Returned

Form of identification.

Allowable Values:

SSN, TIN, SIN, NIN, PASSPORT_NUMBER, DRIVERS_LICENSE, BUSINESS_NUMBER, BUSINESS_TAX_ID, TAXPAYER_REFERENCE

data[].identifications[].value

string
Conditionally returned

Identification number.

Allowable Values:

255 char max

data[].in_current_location_since

datetime
Conditionally returned

The 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
Conditionally returned

Contains information about the organizational structure of the business.

Allowable Values:

Valid incorporation object

data[].incorporation.address_registered_under

object
Conditionally returned

An address associated with the business.

Allowable Values:

Valid address information

data[].incorporation.address_registered_under.address1

string
Conditionally returned

Street address of the business proprietor or officer. Cannot perform KYC if set to a PO Box.

Allowable Values:

35 char max

data[].incorporation.address_registered_under.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

data[].incorporation.address_registered_under.city

string
Conditionally returned

City of business proprietor or officer.

Allowable Values:

35 char max

data[].incorporation.address_registered_under.country

string
Conditionally returned

Country where the business proprietor or officer resides.

Allowable Values:

40 char max

data[].incorporation.address_registered_under.postal_code

string
Conditionally returned

Business proprietor or officer’s postal code.

Allowable Values:

20 char max

data[].incorporation.address_registered_under.state

string
Conditionally returned

State where the business proprietor or officer resides.

Allowable Values:

35 char max

data[].incorporation.address_registered_under.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

data[].incorporation.incorporation_type

string
Conditionally returned

Organizational structure of the business, such as corporation or sole proprietorship.

Allowable Values:

LLC, CORPORATION, SOLE_PROPRIETORSHIP, PARTNERSHIP, COOPERATIVE, OTHER

data[].incorporation.is_public

boolean
Conditionally returned

A value of true indicates that the business is publicly held.

Allowable Values:

true, false

data[].incorporation.name_registered_under

string
Conditionally returned

Name under which the business is registered.

Allowable Values:

255 char max

data[].incorporation.state_of_incorporation

string
Conditionally returned

State where the business is incorporated.

Allowable Values:

255 char max

data[].incorporation.stock_symbol

string
Conditionally returned

Business stock symbol.

Allowable Values:

255 char max

data[].international_office_locations

string
Conditionally returned

The locations of the business' offices outside the US.

Allowable Values:

255 char max

data[].ip_address

string
Conditionally returned

The IP address of the business.

Allowable Values:

39 char max

data[].metadata

object
Conditionally returned

Associates any additional metadata you provide with the business.

Allowable Values:

You can define the names and values of up to 20 fields in the format "my_name_1": "my_value_1".

data[].notes

string
Conditionally returned

Any additional information pertaining to the business.

Allowable Values:

255 char max

data[].office_location

object
Conditionally returned

An address associated with the business.

Allowable Values:

Valid address information

data[].office_location.address1

string
Conditionally returned

Street address of the business proprietor or officer.

Allowable Values:

35 char max

data[].office_location.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

data[].office_location.city

string
Conditionally returned

City of business proprietor or officer.

Allowable Values:

35 char max

data[].office_location.country

string
Conditionally returned

Country where the business proprietor or officer resides.

Allowable Values:

40 char max

data[].office_location.postal_code

string
Conditionally returned

Business proprietor or officer’s postal code.

Allowable Values:

20 char max

data[].office_location.state

string
Conditionally returned

State where the business proprietor or officer resides.

Allowable Values:

35 char max

data[].office_location.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

data[].password

string
Conditionally returned

Password for the business account on the Marqeta platform.

Allowable Values:

1–255 chars

data[].phone

string
Conditionally returned

10-digit telephone number of business.

Allowable Values:

255 char max

data[].primary_contact

object
Conditionally returned

Describes the business' primary contact person.

Allowable Values:

Valid primary_contact object

data[].primary_contact.department

string
Conditionally returned

Business department of the primary contact.

Allowable Values:

255 char max

data[].primary_contact.email

string
Conditionally returned

Email address of the primary contact.

Allowable Values:

255 char max

data[].primary_contact.extension

string
Conditionally returned

Phone extension of the primary contact.

Allowable Values:

255 char max

data[].primary_contact.fax

string
Conditionally returned

Fax number of the primary contact.

Allowable Values:

255 char max

data[].primary_contact.full_name

string
Conditionally returned

Full name of the primary contact.

Allowable Values:

255 char max

data[].primary_contact.mobile

string
Conditionally returned

Mobile phone number of the primary contact.

Allowable Values:

255 char max

data[].primary_contact.phone

string
Conditionally returned

Phone number of the primary contact.

Allowable Values:

255 char max

data[].primary_contact.title

string
Conditionally returned

Title of the primary contact.

Allowable Values:

255 char max

data[].proprietor_is_beneficial_owner

boolean
Conditionally returned

A value of true indicates that the proprietor or officer of the business is also a beneficial owner.

Allowable Values:

true, false

data[].proprietor_or_officer

object
Conditionally returned

Contains information about the proprietor or officer of the business.

Allowable Values:

A valid proprietor_or_officer object

data[].proprietor_or_officer.alternative_names

string
Conditionally returned

Alternate names of the business proprietor or officer.

Allowable Values:

255 char max

data[].proprietor_or_officer.dob

datetime
Conditionally returned

Business proprietor or officer’s date of birth.

Allowable Values:

Format: yyyy-MM-dd or yyyy-MM-ddTHH:mm:ssZ

data[].proprietor_or_officer.email

string
Conditionally returned

Email address of the business proprietor or officer.

Allowable Values:

255 char max

data[].proprietor_or_officer.first_name

string
Returned

First name of business proprietor or officer.

Allowable Values:

255 char max

data[].proprietor_or_officer.home

object
Conditionally returned

An address associated with the business.

Allowable Values:

Valid address information

data[].proprietor_or_officer.home.address1

string
Conditionally returned

Street address of the business proprietor or officer.

Allowable Values:

35 char max

data[].proprietor_or_officer.home.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

data[].proprietor_or_officer.home.city

string
Conditionally returned

City of business proprietor or officer.

Allowable Values:

35 char max

data[].proprietor_or_officer.home.country

string
Conditionally returned

Country where the business proprietor or officer resides.

Allowable Values:

40 char max

data[].proprietor_or_officer.home.postal_code

string
Conditionally returned

Business proprietor or officer’s postal code.

Allowable Values:

20 char max

data[].proprietor_or_officer.home.state

string
Conditionally returned

State where the business proprietor or officer resides.

Allowable Values:

35 char max

data[].proprietor_or_officer.home.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

data[].proprietor_or_officer.identifications

array of objects
Conditionally returned

One or more objects containing personal identifications of the business proprietor or officer.

Allowable Values:

Valid identifications array

data[].proprietor_or_officer.identifications[].expiration_date

string
Conditionally returned

Expiration date for the form of identification, if applicable.

Allowable Values:

Format: yyyy-MM-dd

data[].proprietor_or_officer.identifications[].type

string
Returned

Form of identification.

Allowable Values:

SSN, TIN, SIN, NIN, PASSPORT_NUMBER, DRIVERS_LICENSE, BUSINESS_NUMBER, BUSINESS_TAX_ID, TAXPAYER_REFERENCE

data[].proprietor_or_officer.identifications[].value

string
Conditionally returned

Identification number.

Allowable Values:

255 char max

data[].proprietor_or_officer.last_name

string
Returned

Last name of business proprietor or officer.

Allowable Values:

255 char max

data[].proprietor_or_officer.middle_name

string
Conditionally returned

Middle name of business proprietor or officer.

Allowable Values:

255 char max

data[].proprietor_or_officer.phone

string
Conditionally returned

Telephone number of the business proprietor or officer.

Allowable Values:

Format: 510-555-1212 or 5105551212

data[].proprietor_or_officer.ssn

string
Conditionally returned

The Social Security Number of the business proprietor or officer.

Allowable Values:

Nine digits, no delimiters (123456789, for example)

data[].proprietor_or_officer.title

string
Conditionally returned

Title of business proprietor or officer.

Allowable Values:

255 char max

data[].taxpayer_id

string
Conditionally returned

The taxpayer identifier of the business.

Allowable Values:

255 char max

data[].token

string
Conditionally returned

The unique identifier of the business resource.

Allowable Values:

1–36 chars

data[].website

string
Conditionally returned

URL of the business' website.

Allowable Values:

255 char max

end_index

integer
Conditionally returned

The sort order index of the last resource in the returned array.

Allowable Values:

Any integer

is_more

boolean
Conditionally returned

A value of true indicates that more unreturned resources exist.

Allowable Values:

true, false

start_index

integer
Conditionally returned

The sort order index of the first resource in the returned array.

Allowable Values:

Any integer

Sample response body
JSON
Copied

Is this helpful?

Yes
No

Search businesses

Action: POST
Endpoint: /businesses/lookup

Search for one or more businesses. Include in the message body any parameters by which you want to query. This endpoint supports field filtering and pagination.

Request body
Fields Description

dda

string
Required

The deposit account number of the business.

Allowable Values:

17 char max

Send a GET request to /directdeposits/accounts/{business_token} to retrieve the deposit account number for a specific business.

Send a GET request to /businesses to retrieve business tokens.

Sample request body
JSON
Copied

Is this helpful?

Yes
No
Response body
Fields Description

account_holder_group_token

string
Conditionally returned

Associates the specified account holder group with the business.

Allowable Values:

36 char max

active

boolean
Conditionally returned

A value of true indicates that the business is in the ACTIVE state on the Marqeta platform.

Allowable Values:

true, false

attestation_consent

boolean
Conditionally returned

A value of true indicates that the attester agrees that the information provided is correct and truthful.

Allowable Values:

true, false

attestation_date

datetime
Conditionally returned

The timestamp of the attestation.

Allowable Values:

Format: yyyy-MM-dd or yyyy-MM-ddTHH:mm:ssZ

attester_name

string
Conditionally returned

The name of the attester for KYC verification.

Allowable Values:

64 char max

attester_title

string
Conditionally returned

The title of the attester for KYC verification.

Allowable Values:

64 char max

beneficial_owner1

object
Conditionally returned

Contains information about the beneficial owner of the business, if applicable.

Allowable Values:

Valid beneficial_owner object

beneficial_owner1.dob

datetime
Conditionally returned

Date of birth of the beneficial owner.

Allowable Values:

Format: yyyy-MM-dd

beneficial_owner1.first_name

string
Conditionally returned

First name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner1.home

object
Conditionally returned

An address associated with the business.

Allowable Values:

Valid address information

beneficial_owner1.home.address1

string
Conditionally returned

Street address of the business proprietor or officer.

Allowable Values:

35 char max

beneficial_owner1.home.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

beneficial_owner1.home.city

string
Conditionally returned

City of business proprietor or officer.

Allowable Values:

35 char max

beneficial_owner1.home.country

string
Conditionally returned

Country where the business proprietor or officer resides.

Allowable Values:

40 char max

beneficial_owner1.home.postal_code

string
Conditionally returned

Business proprietor or officer’s postal code.

Allowable Values:

20 char max

beneficial_owner1.home.state

string
Conditionally returned

State where the business proprietor or officer resides.

Allowable Values:

35 char max

beneficial_owner1.home.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

beneficial_owner1.last_name

string
Conditionally returned

Last name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner1.middle_name

string
Conditionally returned

Middle name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner1.phone

string
Conditionally returned

Ten-digit phone number of the beneficial owner.

Allowable Values:

Format: 510-555-1212 or 5105551212

beneficial_owner1.ssn

string
Conditionally returned

Nine-digit Social Security Number (SSN) of the beneficial owner.

Allowable Values:

9 char max

beneficial_owner1.title

string
Conditionally returned

Title of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner2

object
Conditionally returned

Contains information about the beneficial owner of the business, if applicable.

Allowable Values:

Valid beneficial_owner object

beneficial_owner2.dob

datetime
Conditionally returned

Date of birth of the beneficial owner.

Allowable Values:

Format: yyyy-MM-dd

beneficial_owner2.first_name

string
Conditionally returned

First name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner2.home

object
Conditionally returned

An address associated with the business.

Allowable Values:

Valid address information

beneficial_owner2.home.address1

string
Conditionally returned

Street address of the business proprietor or officer.

Allowable Values:

35 char max

beneficial_owner2.home.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

beneficial_owner2.home.city

string
Conditionally returned

City of business proprietor or officer.

Allowable Values:

35 char max

beneficial_owner2.home.country

string
Conditionally returned

Country where the business proprietor or officer resides.

Allowable Values:

40 char max

beneficial_owner2.home.postal_code

string
Conditionally returned

Business proprietor or officer’s postal code.

Allowable Values:

20 char max

beneficial_owner2.home.state

string
Conditionally returned

State where the business proprietor or officer resides.

Allowable Values:

35 char max

beneficial_owner2.home.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

beneficial_owner2.last_name

string
Conditionally returned

Last name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner2.middle_name

string
Conditionally returned

Middle name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner2.phone

string
Conditionally returned

Ten-digit phone number of the beneficial owner.

Allowable Values:

Format: 510-555-1212 or 5105551212

beneficial_owner2.ssn

string
Conditionally returned

Nine-digit Social Security Number (SSN) of the beneficial owner.

Allowable Values:

9 char max

beneficial_owner2.title

string
Conditionally returned

Title of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner3

object
Conditionally returned

Contains information about the beneficial owner of the business, if applicable.

Allowable Values:

Valid beneficial_owner object

beneficial_owner3.dob

datetime
Conditionally returned

Date of birth of the beneficial owner.

Allowable Values:

Format: yyyy-MM-dd

beneficial_owner3.first_name

string
Conditionally returned

First name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner3.home

object
Conditionally returned

An address associated with the business.

Allowable Values:

Valid address information

beneficial_owner3.home.address1

string
Conditionally returned

Street address of the business proprietor or officer.

Allowable Values:

35 char max

beneficial_owner3.home.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

beneficial_owner3.home.city

string
Conditionally returned

City of business proprietor or officer.

Allowable Values:

35 char max

beneficial_owner3.home.country

string
Conditionally returned

Country where the business proprietor or officer resides.

Allowable Values:

40 char max

beneficial_owner3.home.postal_code

string
Conditionally returned

Business proprietor or officer’s postal code.

Allowable Values:

20 char max

beneficial_owner3.home.state

string
Conditionally returned

State where the business proprietor or officer resides.

Allowable Values:

35 char max

beneficial_owner3.home.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

beneficial_owner3.last_name

string
Conditionally returned

Last name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner3.middle_name

string
Conditionally returned

Middle name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner3.phone

string
Conditionally returned

Ten-digit phone number of the beneficial owner.

Allowable Values:

Format: 510-555-1212 or 5105551212

beneficial_owner3.ssn

string
Conditionally returned

Nine-digit Social Security Number (SSN) of the beneficial owner.

Allowable Values:

9 char max

beneficial_owner3.title

string
Conditionally returned

Title of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner4

object
Conditionally returned

Contains information about the beneficial owner of the business, if applicable.

Allowable Values:

Valid beneficial_owner object

beneficial_owner4.dob

datetime
Conditionally returned

Date of birth of the beneficial owner.

Allowable Values:

Format: yyyy-MM-dd

beneficial_owner4.first_name

string
Conditionally returned

First name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner4.home

object
Conditionally returned

An address associated with the business.

Allowable Values:

Valid address information

beneficial_owner4.home.address1

string
Conditionally returned

Street address of the business proprietor or officer.

Allowable Values:

35 char max

beneficial_owner4.home.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

beneficial_owner4.home.city

string
Conditionally returned

City of business proprietor or officer.

Allowable Values:

35 char max

beneficial_owner4.home.country

string
Conditionally returned

Country where the business proprietor or officer resides.

Allowable Values:

40 char max

beneficial_owner4.home.postal_code

string
Conditionally returned

Business proprietor or officer’s postal code.

Allowable Values:

20 char max

beneficial_owner4.home.state

string
Conditionally returned

State where the business proprietor or officer resides.

Allowable Values:

35 char max

beneficial_owner4.home.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

beneficial_owner4.last_name

string
Conditionally returned

Last name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner4.middle_name

string
Conditionally returned

Middle name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner4.phone

string
Conditionally returned

Ten-digit phone number of the beneficial owner.

Allowable Values:

Format: 510-555-1212 or 5105551212

beneficial_owner4.ssn

string
Conditionally returned

Nine-digit Social Security Number (SSN) of the beneficial owner.

Allowable Values:

9 char max

beneficial_owner4.title

string
Conditionally returned

Title of the beneficial owner.

Allowable Values:

255 char max

business_name_dba

string
Conditionally returned

Fictitious business name or "Doing Business As" (DBA).

Allowable Values:

255 char max

business_name_legal

string
Conditionally returned

Legal name of business.

Allowable Values:

255 char max

business_type

string
Conditionally returned

Indicates the type of business (B2B [business-to-business] or B2C [business-to-consumer], for example).

Allowable Values:

255 char max

date_established

datetime
Conditionally returned

Date the business was established.

Allowable Values:

Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ssZ

duns_number

string
Conditionally returned

Data Universal Numbering System (DUNS) number of the business.

Allowable Values:

255 char max

general_business_description

string
Conditionally returned

General description of the business.

Allowable Values:

255 char max

history

string
Conditionally returned

History of the business.

Allowable Values:

255 char max

identifications

array of objects
Conditionally returned

One or more objects containing identifications associated with the business.

Allowable Values:

Valid identifications array

identifications[].expiration_date

string
Conditionally returned

Expiration date for the form of identification, if applicable.

Allowable Values:

Format: yyyy-MM-dd

identifications[].type

string
Returned

Form of identification.

Allowable Values:

SSN, TIN, SIN, NIN, PASSPORT_NUMBER, DRIVERS_LICENSE, BUSINESS_NUMBER, BUSINESS_TAX_ID, TAXPAYER_REFERENCE

identifications[].value

string
Conditionally returned

Identification number.

Allowable Values:

255 char max

in_current_location_since

datetime
Conditionally returned

The date on which the business office opened in its current location.

Allowable Values:

Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ssZ

incorporation

object
Conditionally returned

Contains information about the organizational structure of the business.

Allowable Values:

Valid incorporation object

incorporation.address_registered_under

object
Conditionally returned

An address associated with the business.

Allowable Values:

Valid address information

incorporation.address_registered_under.address1

string
Conditionally returned

Street address of the business proprietor or officer.

Allowable Values:

35 char max

incorporation.address_registered_under.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

incorporation.address_registered_under.city

string
Conditionally returned

City of business proprietor or officer.

Allowable Values:

35 char max

incorporation.address_registered_under.country

string
Conditionally returned

Country where the business proprietor or officer resides.

Allowable Values:

40 char max

incorporation.address_registered_under.postal_code

string
Conditionally returned

Business proprietor or officer’s postal code.

Allowable Values:

20 char max

incorporation.address_registered_under.state

string
Conditionally returned

State where the business proprietor or officer resides.

Allowable Values:

35 char max

incorporation.address_registered_under.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

incorporation.incorporation_type

string
Conditionally returned

Organizational structure of the business, such as corporation or sole proprietorship.

Allowable Values:

LLC, CORPORATION, SOLE_PROPRIETORSHIP, PARTNERSHIP, COOPERATIVE, OTHER

incorporation.is_public

boolean
Conditionally returned

A value of true indicates that the business is publicly held.

Allowable Values:

true, false

incorporation.name_registered_under

string
Conditionally returned

Name under which the business is registered.

Allowable Values:

255 char max

incorporation.state_of_incorporation

string
Conditionally returned

State where the business is incorporated.

Allowable Values:

255 char max

incorporation.stock_symbol

string
Conditionally returned

Business stock symbol.

Allowable Values:

255 char max

international_office_locations

string
Conditionally returned

The locations of the business' offices outside the US.

Allowable Values:

255 char max

ip_address

string
Conditionally returned

The IP address of the business.

Allowable Values:

39 char max

metadata

object
Conditionally returned

Associates any additional metadata you provide with the business.

Allowable Values:

You can define the names and values of up to 20 fields in the format "my_name_1": "my_value_1".

notes

string
Conditionally returned

Any additional information pertaining to the business.

Allowable Values:

255 char max

office_location

object
Conditionally returned

An address associated with the business.

Allowable Values:

Valid address information

office_location.address1

string
Conditionally returned

Street address of the business proprietor or officer. Cannot perform KYC if set to a PO Box.

Allowable Values:

35 char max

office_location.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

office_location.city

string
Conditionally returned

City of business proprietor or officer.

Allowable Values:

35 char max

office_location.country

string
Conditionally returned

Country where the business proprietor or officer resides.

Allowable Values:

40 char max

office_location.postal_code

string
Conditionally returned

Business proprietor or officer’s postal code.

Allowable Values:

20 char max

office_location.state

string
Conditionally returned

State where the business proprietor or officer resides.

Allowable Values:

35 char max

office_location.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

password

string
Conditionally returned

Password for the business account on the Marqeta platform.

Allowable Values:

1–255 chars

phone

string
Conditionally returned

10-digit telephone number of business.

Allowable Values:

255 char max

primary_contact

object
Conditionally returned

Describes the business' primary contact person.

Allowable Values:

Valid primary_contact object

primary_contact.department

string
Conditionally returned

Business department of the primary contact.

Allowable Values:

255 char max

primary_contact.email

string
Conditionally returned

Email address of the primary contact.

Allowable Values:

255 char max

primary_contact.extension

string
Conditionally returned

Phone extension of the primary contact.

Allowable Values:

255 char max

primary_contact.fax

string
Conditionally returned

Fax number of the primary contact.

Allowable Values:

255 char max

primary_contact.full_name

string
Conditionally returned

Full name of the primary contact.

Allowable Values:

255 char max

primary_contact.mobile

string
Conditionally returned

Mobile phone number of the primary contact.

Allowable Values:

255 char max

primary_contact.phone

string
Conditionally returned

Phone number of the primary contact.

Allowable Values:

255 char max

primary_contact.title

string
Conditionally returned

Title of the primary contact.

Allowable Values:

255 char max

proprietor_is_beneficial_owner

boolean
Conditionally returned

A value of true indicates that the proprietor or officer of the business is also a beneficial owner.

Allowable Values:

true, false

proprietor_or_officer

object
Conditionally returned

Contains information about the proprietor or officer of the business.

Allowable Values:

A valid proprietor_or_officer object

proprietor_or_officer.alternative_names

string
Conditionally returned

Alternate names of the business proprietor or officer.

Allowable Values:

255 char max

proprietor_or_officer.dob

datetime
Conditionally returned

Business proprietor or officer’s date of birth.

Allowable Values:

Format: yyyy-MM-dd or yyyy-MM-ddTHH:mm:ssZ

proprietor_or_officer.email

string
Conditionally returned

Email address of the business proprietor or officer.

Allowable Values:

255 char max

proprietor_or_officer.first_name

string
Returned

First name of business proprietor or officer.

Allowable Values:

255 char max

proprietor_or_officer.home

object
Conditionally returned

An address associated with the business.

Allowable Values:

Valid address information

proprietor_or_officer.home.address1

string
Conditionally returned

Street address of the business proprietor or officer.

Allowable Values:

35 char max

proprietor_or_officer.home.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

proprietor_or_officer.home.city

string
Conditionally returned

City of business proprietor or officer.

Allowable Values:

35 char max

proprietor_or_officer.home.country

string
Conditionally returned

Country where the business proprietor or officer resides.

Allowable Values:

40 char max

proprietor_or_officer.home.postal_code

string
Conditionally returned

Business proprietor or officer’s postal code.

Allowable Values:

20 char max

proprietor_or_officer.home.state

string
Conditionally returned

State where the business proprietor or officer resides.

Allowable Values:

35 char max

proprietor_or_officer.home.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

proprietor_or_officer.identifications

array of objects
Conditionally returned

One or more objects containing personal identifications of the business proprietor or officer.

Allowable Values:

Valid identifications array

proprietor_or_officer.identifications[].expiration_date

string
Conditionally returned

Expiration date for the form of identification, if applicable.

Allowable Values:

Format: yyyy-MM-dd

proprietor_or_officer.identifications[].type

string
Returned

Form of identification.

Allowable Values:

SSN, TIN, SIN, NIN, PASSPORT_NUMBER, DRIVERS_LICENSE, BUSINESS_NUMBER, BUSINESS_TAX_ID, TAXPAYER_REFERENCE

proprietor_or_officer.identifications[].value

string
Conditionally returned

Identification number.

Allowable Values:

255 char max

proprietor_or_officer.last_name

string
Returned

Last name of business proprietor or officer.

Allowable Values:

255 char max

proprietor_or_officer.middle_name

string
Conditionally returned

Middle name of business proprietor or officer.

Allowable Values:

255 char max

proprietor_or_officer.phone

string
Conditionally returned

Telephone number of the business proprietor or officer.

Allowable Values:

Format: 510-555-1212 or 5105551212

proprietor_or_officer.ssn

string
Conditionally returned

The Social Security Number of the business proprietor or officer.

Allowable Values:

9 char max

proprietor_or_officer.title

string
Conditionally returned

Title of business proprietor or officer.

Allowable Values:

255 char max

taxpayer_id

string
Conditionally returned

The taxpayer identifier of the business.

Allowable Values:

255 char max

token

string
Conditionally returned

The unique identifier of the business resource.

Allowable Values:

1–36 chars

website

string
Conditionally returned

URL of the business' website.

Allowable Values:

255 char max

Sample response body
JSON
Copied

Is this helpful?

Yes
No

List business children

Action: GET
Endpoint: /businesses/{parent_token}/children

Return an array of all child cardholders of a particular business. Include the parent_token as a URL path parameter.

This endpoint supports field filtering.

URL path parameters
Fields Description

parent_token

string
Required

The unique identifier of the parent business.

Allowable Values:

Existing business token

URL query parameters
Fields Description

count

integer
Optional

The number of child cardholders to retrieve.

Allowable Values:

1-10

start_index

integer
Optional

The sort order index of the first resource in the returned array.

Allowable Values:

Any integer

fields

string
Optional

Comma-delimited list of fields to return (field_1,field_2, and so on). Leave blank to return all fields.

Allowable Values:

Comma-delimited list of fields, or blank

sort_by

string
Optional

Field on which to sort. Use any field in the resource model, or one of the system fields lastModifiedTime or createdTime. Prefix the field name with a hyphen (-) to sort in descending order. Omit the hyphen to sort in ascending order.

Allowable Values:

lastModifiedTime, createdTime, or any field in the resource model

Response body
Fields Description

count

integer
Conditionally returned

The number of resources to retrieve.

Allowable Values:

1-10

data

array of objects
Conditionally returned

An array of cardholder objects.

Allowable Values:

Valid data array

data[].account_holder_group_token

string
Conditionally returned

Associates the specified account holder group with the cardholder.

Allowable Values:

36 char max

data[].active

boolean
Conditionally returned

A value of true indicates that the cardholder is in the ACTIVE state on the Marqeta platform.

Allowable Values:

true, false

data[].address1

string
Conditionally returned

Cardholder’s street address.

Allowable Values:

255 char max

data[].address2

string
Conditionally returned

Additional address information for the cardholder.

Allowable Values:

255 char max

data[].birth_date

string
Conditionally returned

Cardholder’s birth date.

Allowable Values:

Format: yyyy-MM-dd

data[].city

string
Conditionally returned

City where the cardholder resides.

Allowable Values:

40 char max

data[].company

string
Conditionally returned

Company by which the cardholder is employed.

Allowable Values:

255 char max

data[].corporate_card_holder

boolean
Conditionally returned

Specifies if the cardholder holds a corporate card.

Allowable Values:

true, false

data[].country

string
Conditionally returned

Country where the cardholder resides.

Allowable Values:

40 char max

data[].email

string
Conditionally returned

Cardholder’s email address.

Allowable Values:

1–255 chars

data[].first_name

string
Conditionally returned

Cardholder’s first name.

Allowable Values:

40 char max

data[].gender

string
Conditionally returned

Cardholder’s gender.

Allowable Values:

F, M

data[].honorific

string
Conditionally returned

Honorific used to address the cardholder (Doctor, for example).

Allowable Values:

10 char max

data[].id_card_expiration_date

string
Conditionally returned

Expiration date of the cardholder’s identification card.

Allowable Values:

Format: yyyy-MM-dd

data[].id_card_number

string
Conditionally returned

Cardholder’s identification card number.

Allowable Values:

255 char max

data[].identifications

array of objects
Conditionally returned

One or more objects containing identifications associated with the cardholder.

Allowable Values:

Valid identifications array

data[].identifications[].expiration_date

string
Conditionally returned

Expiration date for the form of identification, if applicable.

Allowable Values:

Format: yyyy-MM-dd

data[].identifications[].type

string
Returned

Form of identification.

Allowable Values:

SSN, TIN, SIN, NIN, PASSPORT_NUMBER, DRIVERS_LICENSE, BUSINESS_NUMBER, BUSINESS_TAX_ID, TAXPAYER_REFERENCE

data[].identifications[].value

string
Conditionally returned

Identification number.

Allowable Values:

255 char max

data[].ip_address

string
Conditionally returned

Cardholder’s IP address.

Allowable Values:

39 char max

data[].last_name

string
Conditionally returned

Cardholder’s last name.

Allowable Values:

40 char max

data[].metadata

object
Conditionally returned

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 "my_name_1": "my_value_1".

data[].middle_name

string
Conditionally returned

Cardholder’s middle name.

Allowable Values:

40 char max

data[].nationality

string
Conditionally returned

Cardholder’s nationality.

Allowable Values:

255 char max

data[].notes

string
Conditionally returned

Notes pertaining to the cardholder.

Allowable Values:

255 char max

data[].parent_token

string
Conditionally returned

The business or user token of the cardholder’s parent account.

Allowable Values:

1–36 chars

data[].passport_expiration_date

string
Conditionally returned

Expiration date of the cardholder’s passport.

Allowable Values:

Format: yyyy-MM-dd

data[].passport_number

string
Conditionally returned

Cardholder’s passport number.

Allowable Values:

40 char max

data[].password

string
Conditionally returned

Password to the cardholder’s user account on the Marqeta platform.

Allowable Values:

255 char max

data[].phone

string
Conditionally returned

Cardholder’s phone number.

Allowable Values:

255 char max

data[].postal_code

string
Conditionally returned

Postal code of the cardholder’s address.

Allowable Values:

10 char max

data[].ssn

string
Conditionally returned

Cardholder’s Social Security Number.

Allowable Values:

data[].state

string
Conditionally returned

State where the cardholder resides.

Allowable Values:

32 char max

data[].token

string
Conditionally returned

Unique identifier of the cardholder’s user resource.

Allowable Values:

1–36 chars

data[].uses_parent_account

boolean
Conditionally returned

A value of true indicates that the cardholder is the child of another user account holder or a business account holder.

Allowable Values:

true, false

end_index

integer
Conditionally returned

The sort order index of the last resource in the returned array.

Allowable Values:

Any integer

is_more

boolean
Conditionally returned

A value of true indicates that more unreturned resources exist.

Allowable Values:

true, false

start_index

integer
Conditionally returned

The sort order index of the first resource in the returned array.

Allowable Values:

Any integer

Sample response body
JSON
Copied

Is this helpful?

Yes
No

Retrieve business

Action: GET
Endpoint: /businesses/{token}

Retrieve a specific business. Include the business token path parameter to specify the business to return.

This endpoint supports field filtering and sorting and pagination.

URL path parameters
Fields Description

token

string
Required

Unique identifier of the business resource

Allowable Values:

Existing business token

URL query parameters
Fields Description

fields

string
Optional

Comma-delimited list of fields to return (field_1,field_2, and so on). Leave blank to return all fields.

Allowable Values:

Comma-delimited list of fields, or blank

Response body
Fields Description

account_holder_group_token

string
Conditionally returned

Associates the specified account holder group with the business.

Allowable Values:

36 char max

active

boolean
Conditionally returned

A value of true indicates that the business is in the ACTIVE state on the Marqeta platform.

Allowable Values:

true, false

attestation_consent

boolean
Conditionally returned

A value of true indicates that the attester agrees that the information provided is correct and truthful.

Allowable Values:

true, false

attestation_date

datetime
Conditionally returned

The timestamp of the attestation.

Allowable Values:

Format: yyyy-MM-dd or yyyy-MM-ddTHH:mm:ssZ

attester_name

string
Conditionally returned

The name of the attester for KYC verification.

Allowable Values:

64 char max

attester_title

string
Conditionally returned

The title of the attester for KYC verification.

Allowable Values:

64 char max

authentication

object
Conditionally returned

Contains email address and password information for the business resource.

Allowable Values:

Valid authentication object

authentication.email_verified

boolean
Conditionally returned

A value of true indicates that the email address has been verified.

Allowable Values:

true, false

authentication.email_verified_time

datetime
Conditionally returned

The time and date that the email address was verified.

Allowable Values:

Format: yyyy-MM-ddTHH:mm:ssZ

authentication.last_password_update_channel

string
Conditionally returned

Specifies the channel through which the password was last changed.

Allowable Values:

USER_CHANGE, USER_RESET

authentication.last_password_update_time

datetime
Conditionally returned

The time and date that the password was last changed.

Allowable Values:

Format: yyyy-MM-ddTHH:mm:ssZ

beneficial_owner1

object
Conditionally returned

Contains information about the beneficial owner of the business, if applicable.

Allowable Values:

Existing beneficial_owner object

beneficial_owner1.first_name

string
Conditionally returned

First name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner1.getdob

datetime
Conditionally returned

Date of birth of the beneficial owner.

Allowable Values:

Format: yyyy-MM-dd

beneficial_owner1.home

object
Conditionally returned

The home address of the beneficial owner.

Allowable Values:

Existing home object

beneficial_owner1.home.address1

string
Conditionally returned

Street address.

Allowable Values:

35 char max

beneficial_owner1.home.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

beneficial_owner1.home.city

string
Conditionally returned

City.

Allowable Values:

35 char max

beneficial_owner1.home.country

string
Conditionally returned

Country.

Allowable Values:

40 char max

beneficial_owner1.home.postal_code

string
Conditionally returned

Postal code of the address.

Allowable Values:

20 char max

beneficial_owner1.home.state

string
Conditionally returned

State, province, or territory of the address.

Allowable Values:

35 char max

beneficial_owner1.home.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

beneficial_owner1.last_name

string
Conditionally returned

Last name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner1.middle_name

string
Conditionally returned

Middle name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner1.phone

string
Conditionally returned

Ten-digit phone number of the beneficial owner.

Allowable Values:

Format: 510-555-1212 or 5105551212

beneficial_owner1.title

string
Conditionally returned

Title of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner2

object
Conditionally returned

Contains information about the beneficial owner of the business, if applicable.

Allowable Values:

Existing beneficial_owner object

beneficial_owner2.first_name

string
Conditionally returned

First name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner2.getdob

datetime
Conditionally returned

Date of birth of the beneficial owner.

Allowable Values:

Format: yyyy-MM-dd

beneficial_owner2.home

object
Conditionally returned

The home address of the beneficial owner.

Allowable Values:

Existing home object

beneficial_owner2.home.address1

string
Conditionally returned

Street address.

Allowable Values:

35 char max

beneficial_owner2.home.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

beneficial_owner2.home.city

string
Conditionally returned

City.

Allowable Values:

35 char max

beneficial_owner2.home.country

string
Conditionally returned

Country.

Allowable Values:

40 char max

beneficial_owner2.home.postal_code

string
Conditionally returned

Postal code of the address.

Allowable Values:

20 char max

beneficial_owner2.home.state

string
Conditionally returned

State, province, or territory of the address.

Allowable Values:

35 char max

beneficial_owner2.home.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

beneficial_owner2.last_name

string
Conditionally returned

Last name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner2.middle_name

string
Conditionally returned

Middle name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner2.phone

string
Conditionally returned

Ten-digit phone number of the beneficial owner.

Allowable Values:

Format: 510-555-1212 or 5105551212

beneficial_owner2.title

string
Conditionally returned

Title of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner3

object
Conditionally returned

Contains information about the beneficial owner of the business, if applicable.

Allowable Values:

Existing beneficial_owner object

beneficial_owner3.first_name

string
Conditionally returned

First name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner3.getdob

datetime
Conditionally returned

Date of birth of the beneficial owner.

Allowable Values:

Format: yyyy-MM-dd

beneficial_owner3.home

object
Conditionally returned

The home address of the beneficial owner.

Allowable Values:

Existing home object

beneficial_owner3.home.address1

string
Conditionally returned

Street address.

Allowable Values:

35 char max

beneficial_owner3.home.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

beneficial_owner3.home.city

string
Conditionally returned

City.

Allowable Values:

35 char max

beneficial_owner3.home.country

string
Conditionally returned

Country.

Allowable Values:

40 char max

beneficial_owner3.home.postal_code

string
Conditionally returned

Postal code of the address.

Allowable Values:

20 char max

beneficial_owner3.home.state

string
Conditionally returned

State, province, or territory of the address.

Allowable Values:

35 char max

beneficial_owner3.home.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

beneficial_owner3.last_name

string
Conditionally returned

Last name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner3.middle_name

string
Conditionally returned

Middle name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner3.phone

string
Conditionally returned

Ten-digit phone number of the beneficial owner.

Allowable Values:

Format: 510-555-1212 or 5105551212

beneficial_owner3.title

string
Conditionally returned

Title of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner4

object
Conditionally returned

Contains information about the beneficial owner of the business, if applicable.

Allowable Values:

Existing beneficial_owner object

beneficial_owner4.first_name

string
Conditionally returned

First name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner4.getdob

datetime
Conditionally returned

Date of birth of the beneficial owner.

Allowable Values:

Format: yyyy-MM-dd

beneficial_owner4.home

object
Conditionally returned

The home address of the beneficial owner.

Allowable Values:

Existing home object

beneficial_owner4.home.address1

string
Conditionally returned

Street address.

Allowable Values:

35 char max

beneficial_owner4.home.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

beneficial_owner4.home.city

string
Conditionally returned

City.

Allowable Values:

35 char max

beneficial_owner4.home.country

string
Conditionally returned

Country.

Allowable Values:

40 char max

beneficial_owner4.home.postal_code

string
Conditionally returned

Postal code of the address.

Allowable Values:

20 char max

beneficial_owner4.home.state

string
Conditionally returned

State, province, or territory of the address.

Allowable Values:

35 char max

beneficial_owner4.home.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

beneficial_owner4.last_name

string
Conditionally returned

Last name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner4.middle_name

string
Conditionally returned

Middle name of the beneficial owner.

Allowable Values:

255 char max

beneficial_owner4.phone

string
Conditionally returned

Ten-digit phone number of the beneficial owner.

Allowable Values:

Format: 510-555-1212 or 5105551212

beneficial_owner4.title

string
Conditionally returned

Title of the beneficial owner.

Allowable Values:

255 char max

business_name_dba

string
Conditionally returned

Fictitious business name or "Doing Business As" (DBA).

Allowable Values:

255 char max

business_name_legal

string
Conditionally returned

Legal name of business.

Allowable Values:

255 char max

business_type

string
Conditionally returned

Indicates the type of business (B2B [business-to-business] or B2C [business-to-consumer], for example).

Allowable Values:

255 char max

created_time

datetime
Returned

The date and time when the business was created, in UTC (2021-10-26T20:03:05Z, for example.)

Allowable Values:

Format: yyyy-MM-ddThh:mm:ssZ

date_established

datetime
Conditionally returned

The date and time when the business was established.

Allowable Values:

Format: yyyy-MM-dd or yyyy-MM-ddTHH:mm:ssZ

duns_number

string
Conditionally returned

Data Universal Numbering System (DUNS) number of the business.

Allowable Values:

255 char max

general_business_description

string
Conditionally returned

General description of the business.

Allowable Values:

255 char max

history

string
Conditionally returned

History of the business.

Allowable Values:

255 char max

identifications

array of objects
Conditionally returned

One or more objects containing identifications associated with the business.

Allowable Values:

Existing identifications array

identifications[].expiration_date

string
Conditionally returned

Expiration date for the form of identification, if applicable.

Allowable Values:

Format: yyyy-MM-dd

identifications[].type

string
Conditionally returned

The form of identification.

Allowable Values:

SSN, TIN, SIN, NIN, PASSPORT_NUMBER, DRIVERS_LICENSE, BUSINESS_NUMBER, BUSINESS_TAX_ID, TAXPAYER_REFERENCE

identifications[].value

string
Conditionally returned

Identification number associated with the form of identification.

Allowable Values:

255 char max

in_current_location_since

datetime
Conditionally returned

The date on which the business office opened in its current location.

Allowable Values:

Format: yyyy-MM-dd or yyyy-MM-ddTHH:mm:ssZ

incorporation

object
Conditionally returned

Contains information about the organizational structure of the business.

Allowable Values:

Existing incorporation object

incorporation.address_registered_under

object
Conditionally returned

The registered business address.

Allowable Values:

Existing address_registered_under object

incorporation.address_registered_under.address1

string
Conditionally returned

Street address.

Allowable Values:

35 char max

incorporation.address_registered_under.address2

string
Conditionally returned

Additional address information.

Allowable Values:

35 char max

incorporation.address_registered_under.city

string
Conditionally returned

City.

Allowable Values:

35 char max

incorporation.address_registered_under.country

string
Conditionally returned

Country.

Allowable Values:

40 char max

incorporation.address_registered_under.postal_code

string
Conditionally returned

Postal code of the address.

Allowable Values:

20 char max

incorporation.address_registered_under.state

string
Conditionally returned

State, province, or territory of the address.

Allowable Values:

35 char max

incorporation.address_registered_under.zip

string
Conditionally returned

ZIP code of the address.

Allowable Values:

20 char max

incorporation.incorporation_type

string
Conditionally returned

Organizational structure of the business (corporation or sole proprietorship, for example).

Allowable Values:

LLC, CORPORATION, SOLE_PROPRIETORSHIP, PARTNERSHIP, OTHER

incorporation.is_public

boolean
Conditionally returned

A value of true indicates that the business is publicly held.

Allowable Values:

true, false

incorporation.name_registered_under

string
Conditionally returned

Name under which the business is registered.

Allowable Values:

255 char max

incorporation.state_of_incorporation

string
Conditionally returned

State where the business is incorporated.

Allowable Values:

255 char max

incorporation.stock_symbol

string
Conditionally returned

Stock symbol associated with the business.

Allowable Values:

255 char max

international_office_locations

string
Conditionally returned

The locations of the business' offices outside the US.

Allowable Values:

255 char max

ip_address

string
Conditionally returned

The IP address of the business.

Allowable Values:

39 char max

last_modified_time

datetime
Returned

The date and time when the business was last modified, in UTC. 2021-10-26T20:03:05Z, for example.

Allowable Values:

Format: yyyy-MM-ddThh:mm:ssZ

metadata

object
Conditionally returned

Associates any additional metadata you provide with the business.

Allowable Values:

Existing