{"info":{"_postman_id":"c360f422-8529-45c4-ada7-3a526190282f","name":"API Documentation","description":"

The following documentation describes Infinite Media's company lookup service. The service allows for searching based on URL, telephone number, or company name and any of: street address, city, state, postal code, country. The system can provide back eight different layouts comprising over 60 demographic fields from over half a billion companies internationally.

Please note: The API uses basic authentication - a username and password will be provided when your account is provisioned. If you need to change your credentials, please contact your account rep.

If you'd like a demo account, please contact info@mailinglists.com

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"9231875","collectionId":"c360f422-8529-45c4-ada7-3a526190282f","publishedId":"TzCS6mCH","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2022-12-19T22:11:41.000Z"},"item":[{"name":"Batch","item":[{"name":"Batch Submit","event":[{"listen":"test","script":{"id":"9e4f5e2b-c7c9-4f72-bafa-c58826c65e88","exec":["var jsonData = pm.response.json()\r","pm.environment.set(\"tracking_id\", jsonData.trackingID);"],"type":"text/javascript"}}],"id":"550930ce-8593-47fe-b452-a3db9d92daa2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"matchInput\": [\n {\n \"companyName\": \"IBM\",\n \"country\": \"USA\",\n \"city\": \"Armonk\",\n \"state\": \"NY\",\n \"postalCode\": \"10504\",\n \"matchMethod\": \"cco\"\n },\n {\n \"companyName\": \"Apple\",\n \"country\": \"USA\",\n \"city\": \"Cupertino\",\n \"state\": \"CA\",\n \"postalCode\": \"10504\"\n }\n ],\n \"confidenceCode\": 1,\n \"maxMatches\": 1\n}"},"url":"https://api.mlxp.com/api/v1/batch/json-submit","description":"

Submit a set of records in JSON format for batch matching.

Note: this is limited to payloads of approximately 6MB or less. For larger payloads, please contact your account rep about setting up an SFTP integration.

Payload Structure

{\n    \"matchInput\": [\n        {\n            \"companyName\": \"Infinite Media Concepts, Inc.\",\n            \"country\": \"USA\",\n        },\n        {\n            \"companyName\": \"Apple\",\n            \"country\": \"USA\",\n        }\n    ],\n    \"confidenceCode\": 1,\n    \"skipSizeSort\": 1,\n    \"maxMatches\": 25\n}\n\n

matchInput is required, all other fields are optional.

Within the matchInput list, companyName and country are required, the following fields are optional:

companyName - the name of the company to search for
\n
country - Default USA. the country the company location is in
\n
address - the street or mailing address of the company
\n
city - the physical or mailing city of the company
\n
state - the physical or mailing state of the company
\n
postalCode - the physical or mailing postal code of the company
\n
duns - the duns number of the company
\n
url - the url of the company
\n
phone - the phone number of the company
\n
pobox - the po box or address line 2 of the company
\n
ISO2Country - the two letter ISO 3166 country code of the company (if this is provided, it takes precedence over the “country” parameter)
\n
bypassCache - if 1 is provided for this parameter, the long lived cache will be bypassed
\n
matchMethod - if specified, forces the match back end to use a specific algorithm. Omitting or leaving blank will result in the match method being inferred by what parameters are provided. Any other values for matchMethod will result in a v1 search. This can be one of the following:
\n
- test - used to force a specific response code (specify via the “companyName” parameter) for this request.
  \n
- v2 - use the new enhanced match back end
  \n
- v1 - use the old match back end, full address code path (this assumes city, state, address, postalCode, country are all provided in addition to companyName)
  \n
- duns - search by duns only, even if other parameters are provided
  \n
- url - search by url only, even if other parameters are provided
  \n
- phone - search by phone only, even if other parameters are provided
  \n
- postal - search by postalCode and companyName only, even if other parameters are provided
  \n
- cco - search by companyName, and country only, even if other parameters are provided
  \n
- ccs - search by companyName, state, and country only, even if other parameters are provided (address and postalCode parameters are considered in the search if they are provided)
  \n
- ccsc - search by companyName, city, state, and country only, even if other parameters are provided (address and postalCode parameters are considered in the search if they are provided)
  \n
- cacheOnly - limit the results to the long running cache only. Will return a 404 if the request is not in the cache.
  \n
\n
confidenceCode - Default 1. the minimum confidence code to return records with.
\n
maxMatches - Default 25. the maximum number of matches to return with each matchInput record.
\n
skipSizeSort - if a value of 1 is provided, only sort results by descending confidence code, otherwise results are sorted by descending confidence code, then descending size score. NOTE: this only applies to cco, ccs, and ccsc match methods. All other methods sort on descending confidence code only
\n

\n","auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"{{externalUsername}}"},{"key":"password","value":"{{externalPassword}}"}]},"isInherited":true,"source":{"_postman_id":"c360f422-8529-45c4-ada7-3a526190282f","id":"c360f422-8529-45c4-ada7-3a526190282f","name":"API Documentation","type":"collection"}},"urlObject":{"path":["api","v1","batch","json-submit"],"host":["https://api.mlxp.com"],"query":[],"variable":[]}},"response":[{"id":"1e38d556-6d26-4c95-98b9-f7a2974b030a","name":"Minimal Example","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"matchInput\": [\n {\n \"companyName\": \"IBM\",\n \"country\": \"USA\",\n \"city\": \"Armonk\",\n \"state\": \"NY\",\n \"postalCode\": \"10504\",\n \"matchMethod\": \"cco\"\n },\n {\n \"companyName\": \"Apple\",\n \"country\": \"USA\",\n \"city\": \"Cupertino\",\n \"state\": \"CA\",\n \"postalCode\": \"10504\"\n }\n ],\n \"outputProcessor\": \"dom\",\n \"confidenceCode\": 1,\n \"maxMatches\": 25\n}","options":{"raw":{"language":"json"}}},"url":"https://api.mlxp.com/api/v1/batch/json-submit"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"79"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Sun, 22 Aug 2021 14:11:25 GMT"},{"key":"x-amzn-RequestId","value":"72db3d0e-1981-406a-9dc6-3a4e376e9a0f"},{"key":"X-Malarkey","value":"none"},{"key":"x-amz-apigw-id","value":"EeMpXF93IAMFp0Q="},{"key":"X-Amzn-Trace-Id","value":"Root=1-61225b08-6204e4e32f1714ef32ac411d"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 2f66aa06710fece8ed203ab0ea81eb56.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"IAD89-C3"},{"key":"X-Amz-Cf-Id","value":"DGC-zHcIAAKUqkR2QAq1gfz8MWzLRoL1x1-WxNsPSj19eBbdyStAYg=="}],"cookie":[],"responseTime":null,"body":"{\n \"trackingID\": \"57bb7b13-bccc-477c-bc72-05d0a17e1343\",\n \"status\": \"New Request\"\n}"}],"_postman_id":"550930ce-8593-47fe-b452-a3db9d92daa2"},{"name":"Batch Status","id":"0738d902-efea-4c3e-98bf-b1c4dfbf09e7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.mlxp.com/api/v1/batch/status?tracking_id={{tracking_id}}","description":"

Used to check the status of a batch job submitted via \"Batch Submit\"

Note: These results are only available for 90 days.

(Required) The Tracking ID of the batch run

\n","type":"text/plain"},"key":"tracking_id","value":"{{tracking_id}}"}],"variable":[]}},"response":[{"id":"46a060d9-91be-4e36-b068-83e19ae2af71","name":"Invalid Tracking ID","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: basic","key":"Authorization","value":"Basic "}],"url":{"raw":"https://api.mlxp.com/api/v1/batch/status?tracking_id=6ca2454e-f412-4f74-a98c-b5a5da854361","host":["https://api.mlxp.com"],"path":["api","v1","batch","status"],"query":[{"key":"tracking_id","value":"6ca2454e-f412-4f74-a98c-b5a5da854361"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"text/plain"}],"cookie":[],"responseTime":null,"body":""},{"id":"182e3da6-4f02-4bfc-8f19-43e06274dfec","name":"Valid Tracking ID","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.mlxp.com/api/v1/batch/status?tracking_id={{tracking_id}}","host":["https://api.mlxp.com"],"path":["api","v1","batch","status"],"query":[{"key":"tracking_id","value":"{{tracking_id}}","description":"(Required) The Tracking ID of the batch run"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"156"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Thu, 29 Apr 2021 22:48:07 GMT"},{"key":"x-amzn-RequestId","value":"34d51d5c-a2a0-44fa-b7fd-db0c39ebeaee"},{"key":"X-Malarkey","value":"none"},{"key":"x-amz-apigw-id","value":"ekWiGGvlIAMF-NA="},{"key":"X-Amzn-Trace-Id","value":"Root=1-608b37a6-31e56742559cb0972953c6f3"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 960b27f23df49cd65e51133bf80b9878.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"EWR53-P1"},{"key":"X-Amz-Cf-Id","value":"WBxtkZuwgzDG5kLyiEVh4V2p506feeeCnxhxdMk1KAZ1ypHXW8L4-Q=="}],"cookie":[],"responseTime":null,"body":"{\n \"updated\": \"2021-04-29T22:44:44.991845+00:00\",\n \"rowsTotal\": \"0\",\n \"status\": \"received\",\n \"created\": \"2021-04-29T22:44:44.991845+00:00\",\n \"rowsProcessed\": \"0\"\n}"}],"_postman_id":"0738d902-efea-4c3e-98bf-b1c4dfbf09e7"},{"name":"Batch Results","id":"2fca758c-393f-416d-a268-7301dda55bbf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.mlxp.com/api/v1/batch/json-results?tracking_id={{tracking_id}}","description":"

Used to download the actual results from the batch as Json.

If the batch is still running, this returns a 202-response code. Use the status method to obtain more information about the batch job.

When the tracking id is finished processing, this method will return a 302 redirect to a presigned S3 URL containing the Json results.

Note: These results are only available for 90 days.

The Json results will have the following structure

[\n    {\n        \"inputRecord\": {\n            \"COMPANY_NAME\": \"IBM\",\n            \"COUNTRY_NAME\": \"USA\",\n            \"CITY\": \"Armonk\",\n            \"STATE\": \"NY\",\n            \"ZIP\": \"10504\"\n        },\n        \"matchResults\": [\n            {\n                \"dnb_match_grade\": \"AZZAAZZ\",\n                \"Bemfab_activity_ind \": \"M\",\n                \"dnb_confidence_code\": 8,\n                \"dnb_duns_nbr\": \"123456789\",\n                \"dnb_reason\": \"\",\n                \"size_score\": 85\n            }\n        ]\n    },\n    {\n        \"inputRecord\": {\n            \"COMPANY_NAME\": \"Apple\",\n            \"COUNTRY_NAME\": \"USA\",\n            \"CITY\": \"Cupertino\",\n            \"STATE\": \"CA\",\n            \"ZIP\": \"10504\"\n        },\n        \"matchResults\": [\n            {\n                \"dnb_match_grade\": \"AZZAAZZ\",\n                \"Bemfab_activity_ind \": \"M\",\n                \"dnb_confidence_code\": 8,\n                \"dnb_duns_nbr\": \"123456789\",\n                \"dnb_reason\": \"\",\n                \"size_score\": 85\n            }\n        ]\n    }\n]\n\n

The inputRecord will be repeated for each record submitted, matchResults will be a list of records (up to maxMatches) for each possible match.

matchResults will have the following fields:

dnb_match_grade - a 7 digit code corresponding to the quality of the matched record's fields as they correlate to the input record's fields. The positions correlate to the following fields:
\n
- companyName
- street number (parsed from address)
- street name (parsed from address)
- city / postalCode
- state
- pobox
- telephone
\n
Bemfab_activity_ind - Batch Entity Matching Fabrication and provides the reasons for non-marketability, e.g., undeliverable address, out of business, etc. See the glossary for full details.
\n
dnb_confidence_code - a number in the range of 1-10 indicating the quality of a match. 1 is worst, 10 is best.
\n
dnb_duns_nbr - the duns number of the matched company
\n
dnb_reason - if a match cannot be found, a human readable message may be populated here indicating why
\n
size_score - a number ranging from 1-100 indicating the relative size of the company (as defined by total employees and annual revenue in US dollars) as compared to a theoretical maximum. 1 is smallest, 100 is largest
\n

(Required) The Tracking ID of the batch run

\n","type":"text/plain"},"key":"tracking_id","value":"{{tracking_id}}"}],"variable":[]}},"response":[{"id":"c04f2bc5-bbfd-4240-b722-91418d5bf418","name":"Tracking ID is ready for download","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.mlxp.com/api/v1/batch/json-results?tracking_id=9b79c520-64e7-41d1-a4fb-1a85b2cfe23a","host":["https://api.mlxp.com"],"path":["api","v1","batch","json-results"],"query":[{"key":"tracking_id","value":"9b79c520-64e7-41d1-a4fb-1a85b2cfe23a","description":"(Required) The Tracking ID of the batch run"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"x-amz-id-2","value":"FF6jZGgZNkaUZb3vXtksPlbXmaFyZt6gHIOZmoS4UlDsbcAQ+3r81w+DYAI2EB1AQoKQVsIW54Y="},{"key":"x-amz-request-id","value":"RS0A77KSE20571BC"},{"key":"Date","value":"Thu, 29 Apr 2021 21:43:59 GMT"},{"key":"Last-Modified","value":"Thu, 29 Apr 2021 21:43:10 GMT"},{"key":"x-amz-expiration","value":"expiry-date=\"Thu, 29 Jul 2021 00:00:00 GMT\", rule-id=\"ExpireAfter90Days\""},{"key":"ETag","value":"\"9b70c0fe258ccb7f4d19044975b99fb1\""},{"key":"x-amz-server-side-encryption","value":"AES256"},{"key":"x-amz-version-id","value":"null"},{"key":"Accept-Ranges","value":"bytes"},{"key":"Content-Type","value":"binary/octet-stream"},{"key":"Content-Length","value":"5421"},{"key":"Server","value":"AmazonS3"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"inputRecord\": {\n \"COMPANY_NAME\": \"IBM\",\n \"COUNTRY_NAME\": \"USA\",\n \"CITY\": \"Armonk\",\n \"STATE\": \"NY\",\n \"ZIP\": \"10504\"\n },\n \"matchResults\": [\n {\n \"dnb_match_grade\": \"AZZAAZZ\",\n \"Bemfab_activity_ind \": \"M\",\n \"dnb_confidence_code\": 8,\n \"dnb_duns_nbr\": \"001368083\",\n \"dnb_reason\": \"\",\n \"size_score\": 85\n },\n {\n \"dnb_match_grade\": \"AZZAAZZ\",\n \"Bemfab_activity_ind \": \"M\",\n \"dnb_confidence_code\": 8,\n \"dnb_duns_nbr\": \"612973552\",\n \"dnb_reason\": \"\",\n \"size_score\": 0\n },\n {\n \"dnb_match_grade\": \"AZZAAZZ\",\n \"Bemfab_activity_ind \": \"M\",\n \"dnb_confidence_code\": 8,\n \"dnb_duns_nbr\": \"800046666\",\n \"dnb_reason\": \"\",\n \"size_score\": 0\n },\n {\n \"dnb_match_grade\": \"AZZAAZZ\",\n \"Bemfab_activity_ind \": \"A\",\n \"dnb_confidence_code\": 8,\n \"dnb_duns_nbr\": \"788210032\",\n \"dnb_reason\": \"\",\n \"size_score\": 0\n },\n {\n \"dnb_match_grade\": \"BZZAAZZ\",\n \"Bemfab_activity_ind \": \"M\",\n \"dnb_confidence_code\": 5,\n \"dnb_duns_nbr\": \"037518412\",\n \"dnb_reason\": \"\",\n \"size_score\": 62\n },\n {\n \"dnb_match_grade\": \"BZZAAZZ\",\n \"Bemfab_activity_ind \": \"M\",\n \"dnb_confidence_code\": 5,\n \"dnb_duns_nbr\": \"001697945\",\n \"dnb_reason\": \"\",\n \"size_score\": 79\n },\n {\n \"dnb_match_grade\": \"BZZAAZZ\",\n \"Bemfab_activity_ind \": \"M\",\n \"dnb_confidence_code\": 5,\n \"dnb_duns_nbr\": \"961588188\",\n \"dnb_reason\": \"\",\n \"size_score\": 34\n },\n {\n \"dnb_match_grade\": \"BZZAAZZ\",\n \"Bemfab_activity_ind \": \"M\",\n \"dnb_confidence_code\": 5,\n \"dnb_duns_nbr\": \"117197402\",\n \"dnb_reason\": \"\",\n \"size_score\": 30\n },\n {\n \"dnb_match_grade\": \"BZZAAZZ\",\n \"Bemfab_activity_ind \": \"M\",\n \"dnb_confidence_code\": 5,\n \"dnb_duns_nbr\": \"079450120\",\n \"dnb_reason\": \"\",\n \"size_score\": 23\n },\n {\n \"dnb_match_grade\": \"BZZAAZZ\",\n \"Bemfab_activity_ind \": \"M\",\n \"dnb_confidence_code\": 5,\n \"dnb_duns_nbr\": \"080655424\",\n \"dnb_reason\": \"\",\n \"size_score\": 0\n },\n {\n \"dnb_match_grade\": \"BZZAAZZ\",\n \"Bemfab_activity_ind \": \"M\",\n \"dnb_confidence_code\": 5,\n \"dnb_duns_nbr\": \"117312109\",\n \"dnb_reason\": \"\",\n \"size_score\": 24\n },\n {\n \"dnb_match_grade\": \"BZZAAZZ\",\n \"Bemfab_activity_ind \": \"A\",\n \"dnb_confidence_code\": 5,\n \"dnb_duns_nbr\": \"081059018\",\n \"dnb_reason\": \"\",\n \"size_score\": 25\n },\n {\n \"dnb_match_grade\": \"BZZAAZZ\",\n \"Bemfab_activity_ind \": \"A\",\n \"dnb_confidence_code\": 5,\n \"dnb_duns_nbr\": \"801217964\",\n \"dnb_reason\": \"\",\n \"size_score\": 25\n },\n {\n \"dnb_match_grade\": \"BZZAAZZ\",\n \"Bemfab_activity_ind \": \"A\",\n \"dnb_confidence_code\": 5,\n \"dnb_duns_nbr\": \"832845148\",\n \"dnb_reason\": \"\",\n \"size_score\": 26\n },\n {\n \"dnb_match_grade\": \"BZZAAZZ\",\n \"Bemfab_activity_ind \": \"A\",\n \"dnb_confidence_code\": 5,\n \"dnb_duns_nbr\": \"833026516\",\n \"dnb_reason\": \"\",\n \"size_score\": 23\n },\n {\n \"dnb_match_grade\": \"BZZAAZZ\",\n \"Bemfab_activity_ind \": \"A\",\n \"dnb_confidence_code\": 5,\n \"dnb_duns_nbr\": \"117022494\",\n \"dnb_reason\": \"\",\n \"size_score\": 24\n },\n {\n \"dnb_match_grade\": \"BZZAAZZ\",\n \"Bemfab_activity_ind \": \"A\",\n \"dnb_confidence_code\": 5,\n \"dnb_duns_nbr\": \"787273457\",\n \"dnb_reason\": \"\",\n \"size_score\": 46\n },\n {\n \"dnb_match_grade\": \"BZZAAZZ\",\n \"Bemfab_activity_ind \": \"A\",\n \"dnb_confidence_code\": 5,\n \"dnb_duns_nbr\": \"965511806\",\n \"dnb_reason\": \"\",\n \"size_score\": 25\n },\n {\n \"dnb_match_grade\": \"BZZAAZZ\",\n \"Bemfab_activity_ind \": \"O\",\n \"dnb_confidence_code\": 5,\n \"dnb_duns_nbr\": \"783248040\",\n \"dnb_reason\": \"\",\n \"size_score\": 0\n },\n {\n \"dnb_match_grade\": \"BZZAAZZ\",\n \"Bemfab_activity_ind \": \"O\",\n \"dnb_confidence_code\": 5,\n \"dnb_duns_nbr\": \"783248115\",\n \"dnb_reason\": \"\",\n \"size_score\": 0\n },\n {\n \"dnb_match_grade\": \"BZZAAZZ\",\n \"Bemfab_activity_ind \": \"O\",\n \"dnb_confidence_code\": 5,\n \"dnb_duns_nbr\": \"787841915\",\n \"dnb_reason\": \"\",\n \"size_score\": 0\n }\n ]\n },\n {\n \"inputRecord\": {\n \"COMPANY_NAME\": \"Apple\",\n \"COUNTRY_NAME\": \"USA\",\n \"CITY\": \"Cupertino\",\n \"STATE\": \"CA\",\n \"ZIP\": \"10504\"\n },\n \"matchResults\": [\n {\n \"dnb_match_grade\": \"AZZAAZZ\",\n \"Bemfab_activity_ind \": \"M\",\n \"dnb_confidence_code\": 8,\n \"dnb_duns_nbr\": \"060704780\",\n \"dnb_reason\": \"\",\n \"size_score\": 85\n },\n {\n \"dnb_match_grade\": \"AZZAAZZ\",\n \"Bemfab_activity_ind \": \"A\",\n \"dnb_confidence_code\": 8,\n \"dnb_duns_nbr\": \"080427245\",\n \"dnb_reason\": \"\",\n \"size_score\": 23\n },\n {\n \"dnb_match_grade\": \"AZZAAZZ\",\n \"Bemfab_activity_ind \": \"M\",\n \"dnb_confidence_code\": 8,\n \"dnb_duns_nbr\": \"080154296\",\n \"dnb_reason\": \"\",\n \"size_score\": 0\n },\n {\n \"dnb_match_grade\": \"AZZAAZZ\",\n \"Bemfab_activity_ind \": \"M\",\n \"dnb_confidence_code\": 8,\n \"dnb_duns_nbr\": \"080992975\",\n \"dnb_reason\": \"\",\n \"size_score\": 0\n },\n {\n \"dnb_match_grade\": \"AZZAAZZ\",\n \"Bemfab_activity_ind \": \"O\",\n \"dnb_confidence_code\": 8,\n \"dnb_duns_nbr\": \"079746030\",\n \"dnb_reason\": \"\",\n \"size_score\": 3\n },\n {\n \"dnb_match_grade\": \"AZZAAZZ\",\n \"Bemfab_activity_ind \": \"O\",\n \"dnb_confidence_code\": 8,\n \"dnb_duns_nbr\": \"080341462\",\n \"dnb_reason\": \"\",\n \"size_score\": 26\n },\n {\n \"dnb_match_grade\": \"AZZAAZZ\",\n \"Bemfab_activity_ind \": \"O\",\n \"dnb_confidence_code\": 8,\n \"dnb_duns_nbr\": \"831717462\",\n \"dnb_reason\": \"\",\n \"size_score\": 3\n },\n {\n \"dnb_match_grade\": \"AZZAAZZ\",\n \"Bemfab_activity_ind \": \"O\",\n \"dnb_confidence_code\": 8,\n \"dnb_duns_nbr\": \"078276980\",\n \"dnb_reason\": \"\",\n \"size_score\": 0\n },\n {\n \"dnb_match_grade\": \"AZZAAZZ\",\n \"Bemfab_activity_ind \": \"O\",\n \"dnb_confidence_code\": 8,\n \"dnb_duns_nbr\": \"079370452\",\n \"dnb_reason\": \"\",\n \"size_score\": 0\n },\n {\n \"dnb_match_grade\": \"AZZAAZZ\",\n \"Bemfab_activity_ind \": \"O\",\n \"dnb_confidence_code\": 8,\n \"dnb_duns_nbr\": \"079663366\",\n \"dnb_reason\": \"\",\n \"size_score\": 0\n },\n {\n \"dnb_match_grade\": \"AZZAAZZ\",\n \"Bemfab_activity_ind \": \"O\",\n \"dnb_confidence_code\": 8,\n \"dnb_duns_nbr\": \"080517215\",\n \"dnb_reason\": \"\",\n \"size_score\": 0\n },\n {\n \"dnb_match_grade\": \"AZZAAZZ\",\n \"Bemfab_activity_ind \": \"O\",\n \"dnb_confidence_code\": 8,\n \"dnb_duns_nbr\": \"196472872\",\n \"dnb_reason\": \"\",\n \"size_score\": 0\n },\n {\n \"dnb_match_grade\": \"AZZAAZZ\",\n \"Bemfab_activity_ind \": \"O\",\n \"dnb_confidence_code\": 8,\n \"dnb_duns_nbr\": \"363573882\",\n \"dnb_reason\": \"\",\n \"size_score\": 27\n }\n ]\n }\n]"},{"id":"e5e204a3-21a7-45b9-a03a-60731f8397d4","name":"Tracking ID is still processing","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.mlxp.com/api/v1/batch/json-results?tracking_id={{tracking_id}}","host":["https://api.mlxp.com"],"path":["api","v1","batch","json-results"],"query":[{"key":"tracking_id","value":"{{tracking_id}}","description":"(Required) The Tracking ID of the batch run"}]}},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"0"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Thu, 29 Apr 2021 22:47:26 GMT"},{"key":"x-amzn-RequestId","value":"98801fd6-3036-49b3-8b17-36b429113950"},{"key":"X-Malarkey","value":"none"},{"key":"x-amz-apigw-id","value":"ekWbbFudIAMFoug="},{"key":"X-Amzn-Trace-Id","value":"Root=1-608b377c-227ec7456bd9c80e60ab5a67"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 960b27f23df49cd65e51133bf80b9878.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"EWR53-P1"},{"key":"X-Amz-Cf-Id","value":"5EqNf4CaBmM6RIlNAOG1nmcdHp_h0mEU8fu38cs8m1ERISn2f6no6Q=="}],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"2fca758c-393f-416d-a268-7301dda55bbf"}],"id":"7790d52c-a790-4688-81ca-ab541ec0d675","description":"

These endpoints allow for uploading a set of records in bulk for matching, checking the status of the batch operation, and retrieving the results.

\n","_postman_id":"7790d52c-a790-4688-81ca-ab541ec0d675","auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"{{externalUsername}}"},{"key":"password","value":"{{externalPassword}}"}]},"isInherited":true,"source":{"_postman_id":"c360f422-8529-45c4-ada7-3a526190282f","id":"c360f422-8529-45c4-ada7-3a526190282f","name":"API Documentation","type":"collection"}}},{"name":"Lookup","item":[{"name":"Company Lookup v2","id":"345fdd5b-fe6d-422a-95ad-90977fe22da2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.mlxp.com/api/v2/lookup?duns=&phone&companyName&address&pobox&city&state=&postalCode&country&confidenceCode&layout&matchMethod&ISO3Country&ISO2Country&bypassCache","description":"

Lookup a company in the database by any of company name, address, city, state, zip, country, duns, phone, url

Input parameters are hashed and if the identical request is made again results will be served from the long running cache instead of performing a match engine search. The cache retains results for 30 days.

Parameters

companyName - the name of the company to search for
country - Default USA. the country the company location is in
address - the street or mailing address of the company
city - the physical or mailing city of the company
state - the physical or mailing state of the company
postalCode - the physical or mailing postal code of the company
duns - the duns number of the company
url - the url of the company
phone - the phone number of the company
pobox - the po box or address line 2 of the company
ISO2Country - the two letter ISO 3166 country code of the company (if this is provided, it takes precedence over the “country” parameter)
ISO3Country - the three letter ISO 3166 country code of the company (if this is provided, it takes precedence over the “ISO2Country” and “country” parameters)
bypassCache - if 1 is provided for this parameter, the long lived cache will be bypassed
matchMethod - if specified, forces the match back end to use a specific algorithm. Omitting or leaving blank will result in the match method being inferred by what parameters are provided. Any other values for matchMethod will result in a v1 search. This can be one of the following:
- test - used to force a specific response code (specify via the “companyName” parameter) for this request.
- v2 - use the new enhanced match back end
- v1 - use the old match back end, full address code path (this assumes city, state, address, postalCode, country are all provided in addition to companyName)
- duns - search by duns only, even if other parameters are provided
- url - search by url only, even if other parameters are provided
- phone - search by phone only, even if other parameters are provided
- postal - search by postalCode and companyName only, even if other parameters are provided
- cco - search by companyName, and country only, even if other parameters are provided
- ccs - search by companyName, state, and country only, even if other parameters are provided (address and postalCode parameters are considered in the search if they are provided)
- cacheOnly - limit the results to the long running cache only. Will return a 404 if the request is not in the cache.
\n
skipSizeSort - if a value of 1 is provided, only sort results by descending confidence code, otherwise results are sorted by descending confidence code, then descending size score. NOTE: this only applies to cco, ccs, and ccsc match methods. All other methods sort on descending confidence code only
layout - Default NA. Specify the fields to return. Must be one of the following:
- PA - Fields returned for this record type:
  - BEMFAB
  - CONFIDENCE CODE
  - DUNS NUMBER
  - COMPANY NAME
  - TRADESTYLE NAME
  - PRIMARY ADDRESS
  - CITY
  - STATE/PROVINCE
  - POSTAL CODE
  - COUNTRY
  - PHONE
  - URL
  - SALES VOLUME
  - SALES VOLUME LOCAL
  - EMPLOYEES ON SITE
  - EMPLOYEES TOTAL
  - YEAR STARTED
  - LOCATION TYPE
  - CEO FIRST NAME
  - CEO LAST NAME
  - CEO NAME
  - CEO TITLE
  - LINE OF BUSINESS
  - SIC 1
  - SIC 1 DESCRIPTION
  - SIC 2
  - SIC 2 DESCRIPTION
  - NAICS CODE
  - NAICS DESCRIPTION
  - NAICS CODE 2
  - NAICS CODE 2 DESCRIPTION
  - NON MATCH REASON
  \n
- SA - Fields returned for this record type:
  - BEMFAB
  - CONFIDENCE CODE
  - DUNS NUMBER
  - COMPANY NAME
  - TRADESTYLE NAME
  - PRIMARY ADDRESS
  - CITY
  - STATE/PROVINCE
  - POSTAL CODE
  - COUNTRY
  - PHONE
  - SALES VOLUME
  - SALES VOLUME LOCAL
  - YEAR STARTED
  - LOCATION TYPE
  - CEO FIRST NAME
  - CEO LAST NAME
  - CEO NAME
  - CEO TITLE
  - LINE OF BUSINESS
  - SIC 1
  - SIC 1 DESCRIPTION
  - SIC 2
  - SIC 2 DESCRIPTION
  - NAICS CODE
  - NAICS DESCRIPTION
  - NAICS CODE 2
  - NAICS CODE 2 DESCRIPTION
  - NON MATCH REASON
  \n
- EA - Fields returned for this record type:
  - BEMFAB
  - CONFIDENCE CODE
  - DUNS NUMBER
  - COMPANY NAME
  - TRADESTYLE NAME
  - PRIMARY ADDRESS
  - CITY
  - STATE/PROVINCE
  - POSTAL CODE
  - COUNTRY
  - PHONE
  - EMPLOYEES ON SITE
  - EMPLOYEES TOTAL
  - YEAR STARTED
  - LOCATION TYPE
  - CEO FIRST NAME
  - CEO LAST NAME
  - CEO NAME
  - CEO TITLE
  - LINE OF BUSINESS
  - SIC 1
  - SIC 1 DESCRIPTION
  - SIC 2
  - SIC 2 DESCRIPTION
  - NAICS CODE
  - NAICS DESCRIPTION
  - NAICS CODE 2
  - NAICS CODE 2 DESCRIPTION
  - NON MATCH REASON
  \n
- TA - Fields returned for this record type:
  - BEMFAB
  - CONFIDENCE CODE
  - DUNS NUMBER
  - COMPANY NAME
  - TRADESTYLE NAME
  - PRIMARY ADDRESS
  - CITY
  - STATE/PROVINCE
  - POSTAL CODE
  - COUNTRY
  - PHONE
  - YEAR STARTED
  - LOCATION TYPE
  - CEO FIRST NAME
  - CEO LAST NAME
  - CEO NAME
  - CEO TITLE
  - LINE OF BUSINESS
  - SIC 1
  - SIC 1 DESCRIPTION
  - SIC 2
  - SIC 2 DESCRIPTION
  - NAICS CODE
  - NAICS DESCRIPTION
  - NAICS CODE 2
  - NAICS CODE 2 DESCRIPTION
  - NON MATCH REASON
  \n
- NA - Fields returned for this record type:
  - BEMFAB
  - CONFIDENCE CODE
  - DUNS NUMBER
  - SIC 1
  - SIC 1 DESCRIPTION
  - SIC 2
  - SIC 2 DESCRIPTION
  - NAICS CODE
  - NAICS DESCRIPTION
  - NAICS CODE 2
  - NAICS CODE 2 DESCRIPTION
  - NON MATCH REASON
  \n
- PS - Fields returned for this record type:
  - BEMFAB
  - CONFIDENCE CODE
  - DUNS NUMBER
  - SIC 1
  - NON MATCH REASON
  \n
- PHN - Fields returned for this record type:
  - PHONE
  \n
- ADD ON LAYOUTSIn addition, there are add-on layouts that can be added to any of the above.
  - C
    - BANKRUPTCY INDICATOR
    - BANKRUPTCY DATE
    - BANKRUPTCY CHAPTER
    - BANKRUPTCY STATUS
    - BANKRUPTCY ACTION
    - VIABILITY RATING
    \n
  - I
    - WOMEN OWNED
    - VETERAN OWNED
    - MINORITY OWNED
    - COTTAGE INDICATOR
    \n
  - M
    - IMPORT / EXPORT
    - OWNS / RENTS
    - FRANCHISE
    - PUBLIC / PRIVATE
    - NON-PROFIT
    - LEGAL STATUS
    - SQ FOOTAGE
    \n
  \n
\n

Match Method Selection

Note: if matchMethod is specified, then that algorithm is used, regardless of the below

duns - no other parameters are considered and a duns match is performed
url - no other parameters are considered and a url match is performed
phone - no other parameters are considered, and phone lookup is performed
cacheOnly - only search in the long running cache
companyName and postalCode ONLY - postal code lookup is performed, then city and state from postal database is passed with company name and zip to lookup, standard lookup is performed
companyName and country ONLY - cco lookup is performed
companyName and country and state ONLY - ccs lookup is performed
companyName and country and state and city ONLY - ccsc lookup is performed
if none of the above is true, then a standard lookup is performed

Country field priority

If ISO3country is nonblank and present in the request, that is used over ISO2country
If both are present, then the value passed for ISO3country is used
If all three (country, ISO3Country, ISO2Country) are present, then ISO3country is used
To use just country, do not provide values for ISO2country Or ISO3Country

Duns number to match on. Dashes are allowed, and ignored if present.

\n","type":"text/plain"},"key":"duns","value":""},{"description":{"content":"

Phone number to match on - non numbers are ignored

\n","type":"text/plain"},"key":"phone","value":null},{"description":{"content":"

Company name

\n","type":"text/plain"},"key":"companyName","value":null},{"description":{"content":"

Company address

\n","type":"text/plain"},"key":"address","value":null},{"description":{"content":"

Company address line two

\n","type":"text/plain"},"key":"pobox","value":null},{"description":{"content":"

Company city

\n","type":"text/plain"},"key":"city","value":null},{"description":{"content":"

Company state

\n","type":"text/plain"},"key":"state","value":""},{"description":{"content":"

Company postal code

\n","type":"text/plain"},"key":"postalCode","value":null},{"description":{"content":"

Company country name

\n","type":"text/plain"},"key":"country","value":null},{"description":{"content":"

Confidence code threshold. Results less than this value are not returned.

\n","type":"text/plain"},"key":"confidenceCode","value":null},{"description":{"content":"

Requested layout to return

\n","type":"text/plain"},"key":"layout","value":null},{"description":{"content":"

The match method to use when performing this search

\n","type":"text/plain"},"key":"matchMethod","value":null},{"description":{"content":"

The ISO 3166-1 alpha-2 code

\n","type":"text/plain"},"key":"ISO3Country","value":null},{"description":{"content":"

The ISO 3166-1 alpha-3 code

\n","type":"text/plain"},"key":"ISO2Country","value":null},{"description":{"content":"

If 1, request will bypass the long running cache, regardless of the cachability of the request

\n","type":"text/plain"},"key":"bypassCache","value":null}],"variable":[]}},"response":[{"id":"197c715b-a5c7-4f54-9c28-54d7812fbae8","name":"Lookup by name and address","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.mlxp.com/api/v2/lookup?companyName=Infinite Media Inc&address=190 East Post Rd&pobox=Floor 2&city=White Plains&state=NY&postalCode=12533&country=USA","host":["https://api.mlxp.com"],"path":["api","v2","lookup"],"query":[{"key":"companyName","value":"Infinite Media Inc"},{"key":"address","value":"190 East Post Rd"},{"key":"pobox","value":"Floor 2"},{"key":"city","value":"White Plains"},{"key":"state","value":"NY"},{"key":"postalCode","value":"12533"},{"key":"country","value":"USA","description":"ISO alpha 2 country codes are allowed, as well as full length country names."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"361"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Wed, 14 Apr 2021 00:00:20 GMT"},{"key":"x-amzn-RequestId","value":"5800d3a1-a07a-433a-89ac-0f573b81b374"},{"key":"MLXP-Record-Type","value":"NA"},{"key":"MLXP-Version","value":"2.0.0"},{"key":"X-Malarkey","value":"none"},{"key":"x-amz-apigw-id","value":"dvyFdGf9oAMFSjg="},{"key":"X-Amzn-Trace-Id","value":"Root=1-60763089-592cc5fc456f78713ce908b4"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 9c1dd3a19b345bbdabc718a69ac89c3d.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"EWR52-C3"},{"key":"X-Amz-Cf-Id","value":"h_WmUIQmTYPd9l2AHZfJCozCHvgeM1CRmUd6hiPM7LiWzT1_Ci5wIA=="}],"cookie":[],"responseTime":null,"body":"{\n \"BEMFAB\": \"M\",\n \"CONFIDENCE CODE\": 10,\n \"DUNS NUMBER\": \"826074809\",\n \"SIC 1\": \"73319904\",\n \"SIC 1 DESCRIPTION\": \"Mailing service\",\n \"SIC 2\": \"\",\n \"SIC 2 DESCRIPTION\": \"\",\n \"NAICS CODE\": \"541860\",\n \"NAICS DESCRIPTION\": \"Direct Mail Advertising\",\n \"NAICS CODE 2\": \"\",\n \"NAICS CODE 2 DESCRIPTION\": \"\",\n \"NON MATCH REASON\": \"\",\n \"MATCH GRADE\": \"AAAAAZZ\",\n \"ADDRESS SOURCE\": \"\"\n}"},{"id":"4814518a-6a21-4d22-a785-4fddd4287d53","name":"Company name and country only","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.mlxp.com/api/v2/lookup?companyName=walmart&country=USA","host":["https://api.mlxp.com"],"path":["api","v2","lookup"],"query":[{"key":"companyName","value":"walmart"},{"key":"country","value":"USA","description":"ISO alpha 2 country codes are allowed, as well as full length country names."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"497"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Wed, 14 Apr 2021 00:02:39 GMT"},{"key":"x-amzn-RequestId","value":"b6475eb0-aaea-4cbb-b8e6-395e8f2e1227"},{"key":"MLXP-Record-Type","value":"NA"},{"key":"MLXP-Version","value":"2.0.0"},{"key":"X-Malarkey","value":"none"},{"key":"x-amz-apigw-id","value":"dvycqH1xoAMFSgg="},{"key":"X-Amzn-Trace-Id","value":"Root=1-6076311d-09b08f5c71b25198136e8519"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 9c1dd3a19b345bbdabc718a69ac89c3d.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"EWR52-C3"},{"key":"X-Amz-Cf-Id","value":"bSMPKF8zNhWfjgzQ2LNo_7w5JkT0G0vQ72LSK2f6IThXDvH8Jqax3g=="}],"cookie":[],"responseTime":null,"body":"{\n \"BEMFAB\": \"M\",\n \"CONFIDENCE CODE\": 8,\n \"DUNS NUMBER\": \"138173773\",\n \"SIC 1\": \"59619913\",\n \"SIC 1 DESCRIPTION\": \"General merchandise, mail order\",\n \"SIC 2\": \"51999914\",\n \"SIC 2 DESCRIPTION\": \"General merchandise, non-durable\",\n \"NAICS CODE\": \"454110\",\n \"NAICS DESCRIPTION\": \"Electronic Shopping and Mail-Order Houses\",\n \"NAICS CODE 2\": \"424990\",\n \"NAICS CODE 2 DESCRIPTION\": \"Other Miscellaneous Nondurable Goods Merchant Wholesalers\",\n \"NON MATCH REASON\": \"\",\n \"MATCH GRADE\": \"AZZZZZZ\",\n \"ADDRESS SOURCE\": \"\"\n}"},{"id":"150a434d-12ad-4adc-af41-f9166970daa6","name":"Lookup by phone","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.mlxp.com/api/v2/lookup?phone=9149488300","host":["https://api.mlxp.com"],"path":["api","v2","lookup"],"query":[{"key":"phone","value":"9149488300"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"356"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Wed, 14 Apr 2021 00:03:27 GMT"},{"key":"x-amzn-RequestId","value":"bf307cb5-1d40-40d7-901b-f78b9234dcfe"},{"key":"MLXP-Record-Type","value":"NA"},{"key":"MLXP-Version","value":"2.0.0"},{"key":"X-Malarkey","value":"none"},{"key":"x-amz-apigw-id","value":"dvykOEtooAMFyUA="},{"key":"X-Amzn-Trace-Id","value":"Root=1-6076314e-5795cc793c8fff026f8b01d6"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 9c1dd3a19b345bbdabc718a69ac89c3d.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"EWR52-C3"},{"key":"X-Amz-Cf-Id","value":"LK-dwAriMYcwLeAQFIa9LDR4PHoeGoOkkU42LMaPTQ_sJp8CjKy6Wg=="}],"cookie":[],"responseTime":null,"body":"{\n \"BEMFAB\": \"M\",\n \"CONFIDENCE CODE\": \"10\",\n \"DUNS NUMBER\": \"826074809\",\n \"SIC 1\": \"73319904\",\n \"SIC 1 DESCRIPTION\": \"Mailing service\",\n \"SIC 2\": \"\",\n \"SIC 2 DESCRIPTION\": \"\",\n \"NAICS CODE\": \"541860\",\n \"NAICS DESCRIPTION\": \"Direct Mail Advertising\",\n \"NAICS CODE 2\": \"\",\n \"NAICS CODE 2 DESCRIPTION\": \"\",\n \"NON MATCH REASON\": \"\",\n \"MATCH GRADE\": \"\",\n \"ADDRESS SOURCE\": \"\"\n}"},{"id":"6f03647e-bec5-439e-9e19-8a1559747cfc","name":"Lookup by URL","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.mlxp.com/api/v2/lookup?url=mailinglists.com","host":["https://api.mlxp.com"],"path":["api","v2","lookup"],"query":[{"key":"url","value":"mailinglists.com"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"356"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Wed, 14 Apr 2021 00:04:10 GMT"},{"key":"x-amzn-RequestId","value":"9efc43c1-0420-4435-bc47-ebfde8e55d51"},{"key":"MLXP-Record-Type","value":"NA"},{"key":"MLXP-Version","value":"2.0.0"},{"key":"X-Malarkey","value":"none"},{"key":"x-amz-apigw-id","value":"dvyrEH-1oAMFjXw="},{"key":"X-Amzn-Trace-Id","value":"Root=1-60763179-2ef9de9f41a002f0079f7462"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 9c1dd3a19b345bbdabc718a69ac89c3d.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"EWR52-C3"},{"key":"X-Amz-Cf-Id","value":"NWeu958dmgjphzPQFyd2Q_JBuAJt7TAY5eDSg3zMkqwVxf-ELU8P_g=="}],"cookie":[],"responseTime":null,"body":"{\n \"BEMFAB\": \"M\",\n \"CONFIDENCE CODE\": \"10\",\n \"DUNS NUMBER\": \"826074809\",\n \"SIC 1\": \"73319904\",\n \"SIC 1 DESCRIPTION\": \"Mailing service\",\n \"SIC 2\": \"\",\n \"SIC 2 DESCRIPTION\": \"\",\n \"NAICS CODE\": \"541860\",\n \"NAICS DESCRIPTION\": \"Direct Mail Advertising\",\n \"NAICS CODE 2\": \"\",\n \"NAICS CODE 2 DESCRIPTION\": \"\",\n \"NON MATCH REASON\": \"\",\n \"MATCH GRADE\": \"\",\n \"ADDRESS SOURCE\": \"\"\n}"},{"id":"1fe5cf83-b96d-48bc-91bd-36ae9bc3d2dd","name":"Lookup by DUNS","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.mlxp.com/api/v2/lookup?duns=826074809","host":["https://api.mlxp.com"],"path":["api","v2","lookup"],"query":[{"key":"duns","value":"826074809"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"356"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Wed, 14 Apr 2021 00:04:37 GMT"},{"key":"x-amzn-RequestId","value":"120c12db-2170-4965-92ed-ecc2371235cc"},{"key":"MLXP-Record-Type","value":"NA"},{"key":"MLXP-Version","value":"2.0.0"},{"key":"X-Malarkey","value":"none"},{"key":"x-amz-apigw-id","value":"dvyvKF1HoAMFsOg="},{"key":"X-Amzn-Trace-Id","value":"Root=1-60763194-1827e0903245d299321b371e"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 9c1dd3a19b345bbdabc718a69ac89c3d.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"EWR52-C3"},{"key":"X-Amz-Cf-Id","value":"BPw0-Bc9ImzwmGjVNO2FLFT-xXhg5nNdzFX8vKVfpoz_QC1svUmpqQ=="}],"cookie":[],"responseTime":null,"body":"{\n \"BEMFAB\": \"M\",\n \"CONFIDENCE CODE\": \"10\",\n \"DUNS NUMBER\": \"826074809\",\n \"SIC 1\": \"73319904\",\n \"SIC 1 DESCRIPTION\": \"Mailing service\",\n \"SIC 2\": \"\",\n \"SIC 2 DESCRIPTION\": \"\",\n \"NAICS CODE\": \"541860\",\n \"NAICS DESCRIPTION\": \"Direct Mail Advertising\",\n \"NAICS CODE 2\": \"\",\n \"NAICS CODE 2 DESCRIPTION\": \"\",\n \"NON MATCH REASON\": \"\",\n \"MATCH GRADE\": \"\",\n \"ADDRESS SOURCE\": \"\"\n}"}],"_postman_id":"345fdd5b-fe6d-422a-95ad-90977fe22da2"}],"id":"0d8e1805-f66e-4b3d-b6d1-f6e9fc057c96","description":"

Lookup businesses by address.

\n","_postman_id":"0d8e1805-f66e-4b3d-b6d1-f6e9fc057c96","auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"{{externalUsername}}"},{"key":"password","value":"{{externalPassword}}"}]},"isInherited":true,"source":{"_postman_id":"c360f422-8529-45c4-ada7-3a526190282f","id":"c360f422-8529-45c4-ada7-3a526190282f","name":"API Documentation","type":"collection"}}},{"name":"Glossary","item":[],"id":"dc5538d4-dae0-4957-b5f5-75e00b94169d","description":"

BANKRUPTCY ACTION

I = INVOLUNTARY
V = VOLUNTARY

BANKRUPTCY CHAPTER

Bankruptcy Chapter 07,09,11,12,13

BANKRUPTCY DATE

Bankruptcy Date YYYYMMDD

BANKRUPTCY INDICATOR

Y = indicates that, according to D&B ‘s file, the business is operating under bankruptcy proceedings. This indicator remains until the business either emerges from the proceedings or ceases operations.

BANKRUPTCY STATUS

1 = OPEN
2 = DISMISSED
3 = DISCHARGED
4 = PLAN CONFIRMED
5 = CLOSE
6 = VOID

BEMFAB

Batch Entity Matching Fabrication and provides the reasons for non-marketability, e.g., undeliverable address, out of business, etc.

M = Marketable: Marketable records are intended to be the most useful records to a customer for marketing campaigns.

D = Delisted: Delisted records are active business records that are excluded from marketing products at the request of the management of the business entity.

S = SIC 9999: When D&B is unable to determine a company’s line of business, SIC 9999 will be assigned indicating the line of business has yet to be determined.

X = Other: A record may have insufficient information to categorize or needs revision

A = UTC: An indicator that identifies a record as Undeliverable or Unable to Confirm. Address Undeliverable (Nixie) – indicates that mail sent to the captioned address has been returned.

Y = UTC: Unable to Confirm (UTC) – Identifies records that are showing limited to no activity.

O = OOB: A business which D&B determined as inactive and/or out of business using at least 2 separate authorities to confirm.

CEO FIRST NAME

The first name of the individual who has the highest ranking authority of the business at this location.

CEO LAST NAME

The last name of the individual who has the highest ranking authority of the business at this location.

CEO NAME

The full name of the individual who has the highest ranking authority of the business at this location.

CEO TITLE

The title of the individual with the highest ranking authority at this location. May be abbreviated.

CITY

The name of the city where the business is physically located.

COMPANY NAME

A legal name of the business, in common order.

CONFIDENCE CODE

The following Confidence Codes reflect the quality of a match:
Code Quality Match
8-10 High quality match
5-7 Acceptable for some business applications. User evaluation is usually needed to
select from among candidates.
1-4 Weak match. Not to be used when a positive business identity is required.
0 No match.

COTTAGE INDICATOR

Y = Yes
N = No

COUNTRY

The name of the country where the business is located.

DUNS NUMBER

A randomly generated nine-digit number assigned by Dun & Bradstreet to identify unique business establishments.

EMPLOYEES ON SITE

The number of employees at this location.

EMPLOYEES TOTAL

The total number of employees in the business organization; it should include subsidiary and branch locations.

FRANCHISE

C=Company Owned
F=Franchisee Owner

HIERARCHY CODE

The hierarchy code is a two-digit field which determines the records relative position in a family tree by indicating its relationship to other records. The hierarchy code functions in the following way- Global Ultimates have a hierarchy code of- 01. Subsidiaries have a hierarchy code of one greater than their parents. Branches have a hierarchy code equal to their headquarters.

IMPORT/EXPORT

A code value that identifies whether the business imports goods or services for re-manufacture or sale, exports products or services to a foreign country, and/or is an agent for goods.

LEGAL STATUS

A code value which describes the legal structure of the business

LINE OF BUSINESS

A narrative description of the operations or activities of the business. Relates to the primary four-digit 1987 US SIC.

LOCATION TYPE

B = Business Location
C = Consumer Location

MATCH GRADE

A 7 digit code corresponding to the quality of the matched record's fields as they correlate to the input record's fields. The positions correlate to the following fields:
- companyName
- street number (parsed from address)
- street name (parsed from address)
- city / postalCode
- state
- pobox
- telephone

MINORITY OWNED

MIN = Minority Owned
Blank = Not Minority Owned

NAICS CODE

Primary North American Industry Classification System code

NAICS DESCRIPTION

A textual description of the primary NAICS code

NAICS CODE 2

Secondary North American Industry Classification System code

NAICS CODE 2 DESCRIPTION

A textual description of the secondary NAICS code

NON MATCH REASON

A reason indicating why a match could not be found. May not always be provided.

NON-PROFIT

Y = Is a Non Profit
N = Not a Non Profit

NUMBER OF FAMILY MEMBERS

The number of family members including the global ultimate and all subsidiaries and branches of the entire family tree worldwide. All family members within a particular tree carry the same count.

OWNS / RENTS

0 = N/A
1= Owns
2 = Rents

PHONE

The phone number of the Parent organization.

POSTAL CODE

The postal code of the Parent organization.

PRIMARY ADDRESS

The primary address of the Parent organization.

PUBLIC / PRIVATE

Y = Public
N = Private

SALES VOLUME

The total annual sales/revenue for this business, expressed in US dollars as a signed, decimal field. If the sales/revenue figure is collected in the local currency, the local value is converted to US dollars.

SALES VOLUME LOCAL

The total annual sales/revenue for this business in the local currency. Not available on branch locations.

SIC 1

Standard Industrial Classification (“SIC”) code developed by the United States Government that assigns a code to businesses and other organizations, classifying and subdividing the activity performed by the establishment at that location. Up to a max of four, eight-digit SICs.

SIC 1 DESCRIPTION

A textual description of the primary SIC

SIC 2

SIC 2 DESCRIPTION

A textual description of the secondary SIC

SQ FOOTAGE

1-9 sq ft rounded to 10
10-1000 sq ft rounded to nearest 10
>1000 sq ft rounded to nearest 100
blank if N/A

STATE/PROVINCE

The name of the state/province where the business is located. Generally in the local language.

SUBSIDIARY INDICATOR

Indicates whether the subject business is more than 50% owned by another organization.

TRADESTYLE NAME

A trading style name used by a business. It is an additional name used by a company. Also referred to as \"Doing Business As\" (DBA) and \"Also Known As\" (AKA).

URL

Domain name or Web address of the Subject Duns Number

VETERAN OWNED

VET = Vet
Blank = Not Vet

VIABILITY RATING

Viability Score, Portfolio Comparison, Data Depth, Company Profile

WOMEN OWNED

FEM = Women Owned
Blank = Not Women Owned

YEAR STARTED

The year when current ownership or management assumed control of the business or the year established if no control change has taken place. This is not provided for branch records.

\n","_postman_id":"dc5538d4-dae0-4957-b5f5-75e00b94169d","auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"{{externalUsername}}"},{"key":"password","value":"{{externalPassword}}"}]},"isInherited":true,"source":{"_postman_id":"c360f422-8529-45c4-ada7-3a526190282f","id":"c360f422-8529-45c4-ada7-3a526190282f","name":"API Documentation","type":"collection"}}},{"name":"Health check","id":"0542453c-4260-4676-909d-227c43e494d9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.mlxp.com/health","description":"

Performs a health check against the internals of the lookup engine.

Returns a status of \"UP\" if all is well.

\n","auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"{{externalUsername}}"},{"key":"password","value":"{{externalPassword}}"}]},"isInherited":true,"source":{"_postman_id":"c360f422-8529-45c4-ada7-3a526190282f","id":"c360f422-8529-45c4-ada7-3a526190282f","name":"API Documentation","type":"collection"}},"urlObject":{"path":["health"],"host":["https://api.mlxp.com"],"query":[],"variable":[]}},"response":[{"id":"30ea9281-b26e-4a6f-94f1-ec5d2e1280cf","name":"Healthy result","originalRequest":{"method":"GET","header":[],"url":"https://api.mlxp.com/health"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"16"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Wed, 14 Apr 2021 02:13:02 GMT"},{"key":"x-amzn-RequestId","value":"544c8db7-9772-475c-a78b-e94a945ab6c7"},{"key":"X-Malarkey","value":"none"},{"key":"x-amz-apigw-id","value":"dwFi7GIBIAMFq4A="},{"key":"X-Amzn-Trace-Id","value":"Root=1-60764fac-6d98af4b560e17660e7f21f2"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 13eb5c0e05c1c43ed344f7e14dcf0a01.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"EWR52-C3"},{"key":"X-Amz-Cf-Id","value":"W9hRn_StGCtsSyJI5bumQbbHslOBZM6lpP8smVBDSj9nHPHaIgyNFw=="}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"UP\"\n}"}],"_postman_id":"0542453c-4260-4676-909d-227c43e494d9"}],"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"{{externalUsername}}"},{"key":"password","value":"{{externalPassword}}"}]}},"event":[{"listen":"prerequest","script":{"id":"2e6b0370-2c62-4910-b8f8-4a740b17ad07","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"fa1954df-0364-48a5-aa5f-0a3888ea8b2c","type":"text/javascript","exec":[""]}}],"variable":[{"key":"baseUrl","value":"https://api.mlxp.com"}]}