curl --request POST \
--url https://api.nextlevelmca.com/v1/deals/{id}/datamerch/check \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"force": false
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({query: '<string>', force: false})
};
fetch('https://api.nextlevelmca.com/v1/deals/{id}/datamerch/check', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.nextlevelmca.com/v1/deals/{id}/datamerch/check"
payload = {
"query": "<string>",
"force": False
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"id": "<string>",
"query_type": "ein",
"query_label": "<string>",
"matched": true,
"match_count": 123,
"note_count": 123,
"categories": [
"<string>"
],
"merchants": [
{
"fein": "<string>",
"legal_name": "<string>",
"dba": "<string>",
"address": "<string>",
"street1": "<string>",
"street2": "<string>",
"city": "<string>",
"state": "<string>",
"business_phone": "<string>",
"business_startdate": "<string>",
"industry": "<string>",
"notes": [
{
"category": "<string>",
"note": "<string>",
"created_at": "<string>",
"added_by": "<string>"
}
]
}
],
"error": "<string>",
"checked_at": "<string>",
"checked_by_name": "<string>",
"cached": true
},
"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>"
}
}Check a deal’s business in DataMerch
Looks the business up in DataMerch with the workspace’s own credentials and stores the result on the deal. Searches by the EIN on file, or by legal name when there is no EIN (name hits are possible matches, not confirmed; compare city and state). An identical check from the last 24 hours is returned with cached: true unless force is set. Fails with datamerch_not_connected when the workspace has not connected DataMerch in Settings → Integrations. A vendor outage or rejected credentials come back as a check with error set, not as an HTTP error.
curl --request POST \
--url https://api.nextlevelmca.com/v1/deals/{id}/datamerch/check \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"force": false
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({query: '<string>', force: false})
};
fetch('https://api.nextlevelmca.com/v1/deals/{id}/datamerch/check', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.nextlevelmca.com/v1/deals/{id}/datamerch/check"
payload = {
"query": "<string>",
"force": False
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"id": "<string>",
"query_type": "ein",
"query_label": "<string>",
"matched": true,
"match_count": 123,
"note_count": 123,
"categories": [
"<string>"
],
"merchants": [
{
"fein": "<string>",
"legal_name": "<string>",
"dba": "<string>",
"address": "<string>",
"street1": "<string>",
"street2": "<string>",
"city": "<string>",
"state": "<string>",
"business_phone": "<string>",
"business_startdate": "<string>",
"industry": "<string>",
"notes": [
{
"category": "<string>",
"note": "<string>",
"created_at": "<string>",
"added_by": "<string>"
}
]
}
],
"error": "<string>",
"checked_at": "<string>",
"checked_by_name": "<string>",
"cached": true
},
"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
Path Parameters
Deal id
Body
What to search by. Omit to use the 9-digit EIN on file, falling back to the legal name.
ein, name Name keywords for a name search (default: the legal name on file). Ignored for an EIN search.
120Ask DataMerch again even when an identical check ran in the last 24 hours.
Was this page helpful?