Create Business

post

https://api.firstorion.com/exchange/v1/businesses

Please provide complete and accurate data about your business to reduce processing and vetting time. If the information you provide is incorrect, business vetting time could take up to 3-5 business days.

The following data elements provided will reduce processing and vetting time and should be considered required for appropriate business vetting:

Legal Business Name
Primary phone number
Street address
City
State
Zip
Industry
Employee count
Primary contact name
Primary contact email
Primary contact phone number

The following fields are considered recommended and can reduce processing and vetting time:

DBA
Website URL
Tax ID
Duns Number

Based on the data provided a business will be placed in the following status:

APPROVED
UNDER_REVIEW
PENDING
REJECTED

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

legalName

string

required

4 to 256

Legal name of the business. It is highly recommended not to update legalName after it has been initially set.

primaryPhoneNumber

string

required

7 to 15

Phone number in E.164 format.

taxId

string

Tax ID number for the business. If using standard tax id, the format needs to be "12-1234567". If using SSN, the format must be "123-12-1234".

addresses

array of objects

required

length ≥ 1

List of locations/addresses for the business

addresses*

primaryLocation

boolean

Defaults to false

Is this the primary address for the business.

streetAddress1

string

required

≤ 256

Street address for the business address.

streetAddress2

string

≤ 256

streetAddress3

string

≤ 256

postalCode

string

required

5 to 10

city

string

required

1 to 256

City of the address.

state

string

State or providence if applicable.

countryCode

string

required

2 to 2

Two character ISO country code for the country of the address. (Please refer to full list e.g. at https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)

administrativeContacts

array of objects

required

length ≥ 1

Administrative contacts of the business.

administrativeContacts*

string

required

6 to 256

Email address for the contact person.

contactName

string

required

1 to 256

Full name (FirstName LastName) of the contact person.

phoneNumber

string

required

7 to 15

Phone number in E.164 format.

context

object

required

Contextual information related to the business.

dba

string

≤ 256

Doing Business As

demographics

object

dunsNumber

string

Duns & Bradstreet Number for the business

tfaDeliveryMethod

string

enum

Defaults to sms

How should a two factor authentication code be delivered to the primaryPhoneNumber

Allowed:

website

string

≤ 256

Website of the business in question

numberProviders

array of strings

length ≤ 7

Providers for your businesses numbers.

numberProviders

201Created

400Bad Request

409Conflict