Skip to content
Risk & Fraud

Business Verify

One score for whether a business is real, open and reachable.

POST/v1/business-verify
30 credits / checkBulk supportedUS, UK, Canada, Australia and the EU
Request
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"}'
Response
{
  "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>required

Your 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_namestringrequired

Business name. Example: Northwind Coffee Roasters

citystringrequired

City and state. Example: Portland, OR

domainstring<domain>

Website. Example: example.com

phone_numberstring<E.164>

Phone number. Example: +15125550142

freshboolean

Skip the 7-day cache and run a new lookup. Charged as a normal lookup.

referencestring

Your 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.

successboolean

true when the lookup ran.

data.confidence_scorenumber

0 to 100. How strongly the listing, website and phone evidence agree that the business is real and operating.

data.checks.listing.foundboolean

Whether a public business listing matches the name and city you sent.

data.checks.listing.open_statusstring

operational, temporarily_closed or permanently_closed, as shown on the listing.

data.checks.listing.rating_countnumber

How many ratings the listing has collected. A long review history is hard to fake.

data.checks.website.tls_validboolean

Whether the website serves a valid certificate. Whether it resolves at all is in checks.website.resolves.

data.checks.website.domain_age_daysnumber

Days since the website's domain was registered.

data.checks.phone.line_typestring

mobile, landline or voip for the number you supplied.

data.checks.phone.matches_listingboolean

Whether your phone number is the one published on the listing.

meta.credits_usednumber

Credits charged for this call.

meta.credits_remainingnumber

Your balance after the call.

meta.cachedboolean

true when the result came from the 7-day cache.

meta.request_idstring

Quote 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.

HTTPCodeMeaning
401unauthorizedThe key is missing, malformed or revoked.
402insufficient_creditsYour credits are used up and pay as you go is off or at its limit.
422invalid_inputA field is missing or malformed. The field property names it.
429rate_limitedToo many requests for this key. Wait for the Retry-After interval.
500internal_errorSomething failed on our side. Safe to retry.
503source_unavailableAn 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