API Endpoint: Company Details Lookup by Name Address

The company-details-lookup-by-name-address endpoint returns business details for a company name, an address, or both.

POST /api/v1/validate/company-details-lookup-by-name-address

https://www.tincomply.com/api/v1/validate/company-details-lookup-by-name-address

Look up a business by legal name, by address, or both. Returns matching companies with their address, phone, website and other public attributes, each with a match confidence.

Request body

FieldTypeDescription
name string Company name.
street, suite, city, state, zip5, zip4 string Address fields.
address string Single-line address, as an alternative to the structured fields.

Response object: companyDetailsLookupByNameAddressResult

FieldTypeDescription
resultsarrayMatching companies, omitted when there are none. Each item has name, type, confidence and properties (attribute to value).
anyFilteredboolAlways false for this service.
completedboolFalse when the upstream source was unavailable. The request is retried automatically; call request-details with the request id later to get the finished result.

What to do with this result

When you seeDo this
A result at high confidenceUse its properties to fill in or confirm your record: address, phone, website.
Only low-confidence results, or noneSend more of what you know (the full address as well as the name) and try again.
completed is falseThe source was unavailable. Keep the request id and call request-details later; the result fills in once the retry succeeds.

Sample request

curl -X POST https://www.tincomply.com/api/v1/validate/company-details-lookup-by-name-address \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"INTERNATIONAL BUSINESS MACHINES CORPORATION","street":"1 NEW ORCHARD RD","city":"ARMONK","state":"NY","zip5":"10504"}'

Sample response

{
  "id": "Hk8sJ2nQ4wE6rT0yUiOpLa3S",
  "request": {
    "name": "INTERNATIONAL BUSINESS MACHINES CORPORATION",
    "street": "1 NEW ORCHARD RD",
    "city": "ARMONK",
    "state": "NY",
    "zip5": "10504",
    "requestDate": "2026-10-01T14:02:11Z",
    "requestedServices": "company-details-lookup-by-name-address"
  },
  "companyDetailsLookupByNameAddressResult": {
    "completed": true,
    "anyFiltered": false,
    "results": [
      {
        "name": "International Business Machines Corporation",
        "type": "Organization",
        "confidence": 100,
        "properties": {
          "names": "INTERNATIONAL BUSINESS MACHINES CORPORATION",
          "address": "1 NEW ORCHARD RD, ARMONK, NY 10504-1722",
          "country": "United States",
          "phonenumbers": "(914) 499-1900",
          "relatedWebsites": "https://www.ibm.com"
        }
      }
    ]
  }
}

Errors

Requests that cannot be processed return HTTP 400 with an object keyed by field name, each listing what was wrong. Authentication, permission and other status codes are covered in Errors & service status.

This endpoint requires an API key with the Validate permission.

See how this check works in the portal and what it costs: Company Details Lookup