curl --request POST \
--url https://api.nextlevelmca.com/v1/businesses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"legal_name": "<string>",
"dba": "<string>",
"ein": "<string>",
"entity_type": "<string>",
"industry": "<string>",
"address": "<string>",
"city": "<string>",
"state": "<string>",
"zip": "<string>",
"phone": "<string>",
"email": "<string>",
"business_start_date": "2018-03-01",
"status": "active",
"tags": [
"<string>"
],
"custom_data": {}
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
legal_name: '<string>',
dba: '<string>',
ein: '<string>',
entity_type: '<string>',
industry: '<string>',
address: '<string>',
city: '<string>',
state: '<string>',
zip: '<string>',
phone: '<string>',
email: '<string>',
business_start_date: '2018-03-01',
status: 'active',
tags: ['<string>'],
custom_data: {}
})
};
fetch('https://api.nextlevelmca.com/v1/businesses', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.nextlevelmca.com/v1/businesses"
payload = {
"legal_name": "<string>",
"dba": "<string>",
"ein": "<string>",
"entity_type": "<string>",
"industry": "<string>",
"address": "<string>",
"city": "<string>",
"state": "<string>",
"zip": "<string>",
"phone": "<string>",
"email": "<string>",
"business_start_date": "2018-03-01",
"status": "active",
"tags": ["<string>"],
"custom_data": {}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"id": "<string>",
"legal_name": "<string>",
"dba": "<string>",
"ein": "<string>",
"entity_type": "<string>",
"industry": "<string>",
"address": "<string>",
"city": "<string>",
"state": "<string>",
"zip": "<string>",
"phone": "<string>",
"email": "<string>",
"business_start_date": "<string>",
"status": "active",
"tags": [
"<string>"
],
"custom_data": {},
"primary_contact": {
"id": "<string>",
"name": "<string>",
"email": "<string>",
"phone": "<string>"
},
"deal_count": 123,
"lifetime_funded": 123,
"active_advances": 123,
"outstanding_balance": 123,
"last_activity_at": "<string>",
"created_at": "<string>",
"updated_at": "<string>"
},
"meta": {}
}{
"error": {
"type": "validation_error",
"message": "<string>",
"request_id": "<string>",
"code": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "validation_error",
"message": "<string>",
"request_id": "<string>",
"code": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "validation_error",
"message": "<string>",
"request_id": "<string>",
"code": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "validation_error",
"message": "<string>",
"request_id": "<string>",
"code": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "validation_error",
"message": "<string>",
"request_id": "<string>",
"code": "<string>",
"param": "<string>"
}
}Create a business
Creates a merchant business. Duplicate detection runs first: a matching EIN, or the same normalised legal name in the same state with no conflicting EIN, answers 409 duplicate_business with existing_id (use that business instead). Pass ?force=true to create anyway. Send Idempotency-Key to make retries safe.
curl --request POST \
--url https://api.nextlevelmca.com/v1/businesses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"legal_name": "<string>",
"dba": "<string>",
"ein": "<string>",
"entity_type": "<string>",
"industry": "<string>",
"address": "<string>",
"city": "<string>",
"state": "<string>",
"zip": "<string>",
"phone": "<string>",
"email": "<string>",
"business_start_date": "2018-03-01",
"status": "active",
"tags": [
"<string>"
],
"custom_data": {}
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
legal_name: '<string>',
dba: '<string>',
ein: '<string>',
entity_type: '<string>',
industry: '<string>',
address: '<string>',
city: '<string>',
state: '<string>',
zip: '<string>',
phone: '<string>',
email: '<string>',
business_start_date: '2018-03-01',
status: 'active',
tags: ['<string>'],
custom_data: {}
})
};
fetch('https://api.nextlevelmca.com/v1/businesses', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.nextlevelmca.com/v1/businesses"
payload = {
"legal_name": "<string>",
"dba": "<string>",
"ein": "<string>",
"entity_type": "<string>",
"industry": "<string>",
"address": "<string>",
"city": "<string>",
"state": "<string>",
"zip": "<string>",
"phone": "<string>",
"email": "<string>",
"business_start_date": "2018-03-01",
"status": "active",
"tags": ["<string>"],
"custom_data": {}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"id": "<string>",
"legal_name": "<string>",
"dba": "<string>",
"ein": "<string>",
"entity_type": "<string>",
"industry": "<string>",
"address": "<string>",
"city": "<string>",
"state": "<string>",
"zip": "<string>",
"phone": "<string>",
"email": "<string>",
"business_start_date": "<string>",
"status": "active",
"tags": [
"<string>"
],
"custom_data": {},
"primary_contact": {
"id": "<string>",
"name": "<string>",
"email": "<string>",
"phone": "<string>"
},
"deal_count": 123,
"lifetime_funded": 123,
"active_advances": 123,
"outstanding_balance": 123,
"last_activity_at": "<string>",
"created_at": "<string>",
"updated_at": "<string>"
},
"meta": {}
}{
"error": {
"type": "validation_error",
"message": "<string>",
"request_id": "<string>",
"code": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "validation_error",
"message": "<string>",
"request_id": "<string>",
"code": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "validation_error",
"message": "<string>",
"request_id": "<string>",
"code": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "validation_error",
"message": "<string>",
"request_id": "<string>",
"code": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "validation_error",
"message": "<string>",
"request_id": "<string>",
"code": "<string>",
"param": "<string>"
}
}Authorizations
API key (nlmca_live_…) or OAuth access token
Query Parameters
Create even when a duplicate exists (same EIN, or same normalised legal name in the same state with no conflicting EIN). Without it the API answers 409 duplicate_business with existing_id.
Body
Legal name of the business.
255Doing-business-as name.
255Employer identification number, any format (digits are compared for duplicate detection).
20Entity type, e.g. LLC, Corporation, Sole Proprietorship.
50Industry, free text. Lender criteria match on it.
100Street address.
100State, e.g. NY. Part of the duplicate rule together with the legal name.
5020Business phone, any format.
50255Date the business started, YYYY-MM-DD. Drives time-in-business for lender matching.
"2018-03-01"
active, inactive, watchlist Free-form tags.
Arbitrary JSON kept on the business (your own ids, attributes). Replaced as a whole on update.
Was this page helpful?