Business Verify
One score for whether a business is real, open and reachable.
curl -X POST https://api.1lookup.dev/v1/business-verify \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"business_name":"Northwind Coffee Roasters","city":"Portland, OR"}'{
"success": true,
"data": {
"input": {
"business_name": "Northwind Coffee Roasters",
"city": "Portland, OR",
"domain": "northwindcoffee.example",
"phone_number": "+15035550118"
},
"confidence_score": 91,
"checks": {
"listing": {
"found": true,
"name": "Northwind Coffee Roasters",
"address": "1200 Example Ave, Portland, OR 97205",
"open_status": "operational",
"rating_count": 412
},
"website": {
"resolves": true,
"tls_valid": true,
"domain_created": "2018-02-01",
"domain_age_days": 3213
},
"phone": {
"valid": true,
"line_type": "landline",
"matches_listing": true
}
},
"flags": []
},
"meta": {
"credits_used": 30,
"credits_remaining": 999,
"cached": false,
"request_id": "req_8f3a2c1e9b7d"
}
}Authorization
Authorizationstring<bearer>requiredYour API key as a Bearer token. Live keys start with 1lk_live_. Test keys start with 1lk_test_ and return this endpoint's sample response without spending credits. See authentication.
Body
Send the fields as a JSON object with Content-Type: application/json.
business_namestringrequiredBusiness name. Example: Northwind Coffee Roasters
citystringrequiredCity and state. Example: Portland, OR
domainstring<domain>Website. Example: example.com
phone_numberstring<E.164>Phone number. Example: +15125550142
freshbooleanSkip the 7-day cache and run a new lookup. Charged as a normal lookup.
referencestringYour own identifier, echoed back in meta and shown in lookup history.
Response
A 200 response carries the result in data and the cost of the call in meta. These are the fields most integrations read.
successbooleantrue when the lookup ran.
data.confidence_scorenumber0 to 100. How strongly the listing, website and phone evidence agree that the business is real and operating.
data.checks.listing.foundbooleanWhether a public business listing matches the name and city you sent.
data.checks.listing.open_statusstringoperational, temporarily_closed or permanently_closed, as shown on the listing.
data.checks.listing.rating_countnumberHow many ratings the listing has collected. A long review history is hard to fake.
data.checks.website.tls_validbooleanWhether the website serves a valid certificate. Whether it resolves at all is in checks.website.resolves.
data.checks.website.domain_age_daysnumberDays since the website's domain was registered.
data.checks.phone.line_typestringmobile, landline or voip for the number you supplied.
data.checks.phone.matches_listingbooleanWhether your phone number is the one published on the listing.
meta.credits_usednumberCredits charged for this call.
meta.credits_remainingnumberYour balance after the call.
meta.cachedbooleantrue when the result came from the 7-day cache.
meta.request_idstringQuote this when you contact support.
Errors
A failed request returns success: false with an error object, and is never charged. The full list is on the errors page.
| HTTP | Code | Meaning |
|---|---|---|
| 401 | unauthorized | The key is missing, malformed or revoked. |
| 402 | insufficient_credits | Your credits are used up and pay as you go is off or at its limit. |
| 422 | invalid_input | A field is missing or malformed. The field property names it. |
| 429 | rate_limited | Too many requests for this key. Wait for the Retry-After interval. |
| 500 | internal_error | Something failed on our side. Safe to retry. |
| 503 | source_unavailable | An upstream source did not answer in time. Safe to retry. |
Billing
30 credits / check. Charged when the lookup runs and returns a result. Errors are never charged, and repeating the same input within 7 days is served from cache at no charge.
Product overview and use cases