Skip to main content
POST
Create a business

Authorizations

Authorization
string
header
required

API key (nlmca_live_…) or OAuth access token

Query Parameters

force
boolean
default:false

Create even when a duplicate exists (same EIN, or same normalised legal name in the same state). Without it the API answers 409 duplicate_business with existing_id.

Body

application/json

Legal name of the business.

Maximum string length: 255
dba
string

Doing-business-as name.

Maximum string length: 255
ein
string

Employer identification number, any format (digits are compared for duplicate detection).

Maximum string length: 20
entity_type
string

Entity type, e.g. LLC, Corporation, Sole Proprietorship.

Maximum string length: 50
industry
string

Industry, free text. Lender criteria match on it.

Maximum string length: 100
address
string

Street address.

city
string
Maximum string length: 100
state
string

State, e.g. NY. Part of the duplicate rule together with the legal name.

Maximum string length: 50
zip
string
Maximum string length: 20
phone
string

Business phone, any format.

Maximum string length: 50
email
string
Maximum string length: 255
business_start_date
string

Date the business started, YYYY-MM-DD. Drives time-in-business for lender matching.

Example:

"2018-03-01"

status
enum<string>
default:active
Available options:
active,
inactive,
watchlist
tags
string[]

Free-form tags.

custom_data
object

Arbitrary JSON kept on the business (your own ids, attributes). Replaced as a whole on update.

Response

Created

data
object
required
meta
object
required