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
| Field | Type | Description |
|---|---|---|
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
| Field | Type | Description |
|---|---|---|
results | array | Matching companies, omitted when there are none. Each item has name, type, confidence and properties (attribute to value). |
anyFiltered | bool | Always false for this service. |
completed | bool | False 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 see | Do this |
|---|---|
| A result at high confidence | Use its properties to fill in or confirm your record: address, phone, website. |
| Only low-confidence results, or none | Send more of what you know (the full address as well as the name) and try again. |
| completed is false | The 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"}'import requests
response = requests.post(
"https://www.tincomply.com/api/v1/validate/company-details-lookup-by-name-address",
headers={"X-API-Key": "YOUR_API_KEY"},
json={
"name": "INTERNATIONAL BUSINESS MACHINES CORPORATION",
"street": "1 NEW ORCHARD RD",
"city": "ARMONK",
"state": "NY",
"zip5": "10504",
},
)
response.raise_for_status()
print(response.json()["companyDetailsLookupByNameAddressResult"])using System.Text;
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", "YOUR_API_KEY");
var body = """
{
"name": "INTERNATIONAL BUSINESS MACHINES CORPORATION",
"street": "1 NEW ORCHARD RD",
"city": "ARMONK",
"state": "NY",
"zip5": "10504"
}
""";
var response = await client.PostAsync(
"https://www.tincomply.com/api/v1/validate/company-details-lookup-by-name-address",
new StringContent(body, Encoding.UTF8, "application/json"));
Console.WriteLine(await response.Content.ReadAsStringAsync());const response = await fetch("https://www.tincomply.com/api/v1/validate/company-details-lookup-by-name-address", {
method: "POST",
headers: {
"X-API-Key": "YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
name: "INTERNATIONAL BUSINESS MACHINES CORPORATION",
street: "1 NEW ORCHARD RD",
city: "ARMONK",
state: "NY",
zip5: "10504",
}),
});
const data = await response.json();
console.log(data.companyDetailsLookupByNameAddressResult);import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
String body = """
{
"name": "INTERNATIONAL BUSINESS MACHINES CORPORATION",
"street": "1 NEW ORCHARD RD",
"city": "ARMONK",
"state": "NY",
"zip5": "10504"
}
""";
HttpRequest request = HttpRequest.newBuilder(URI.create("https://www.tincomply.com/api/v1/validate/company-details-lookup-by-name-address"))
.header("X-API-Key", "YOUR_API_KEY")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(body))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
// Parse with your JSON library (Jackson, Gson) and read companyDetailsLookupByNameAddressResult.
System.out.println(response.body());
}
}package main
import (
"bytes"
"encoding/json"
"fmt"
"log"
"net/http"
)
func main() {
body := []byte(`{
"name": "INTERNATIONAL BUSINESS MACHINES CORPORATION",
"street": "1 NEW ORCHARD RD",
"city": "ARMONK",
"state": "NY",
"zip5": "10504"
}`)
req, err := http.NewRequest("POST", "https://www.tincomply.com/api/v1/validate/company-details-lookup-by-name-address", bytes.NewReader(body))
if err != nil {
log.Fatal(err)
}
req.Header.Set("X-API-Key", "YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
var data map[string]any
if err := json.NewDecoder(resp.Body).Decode(&data); err != nil {
log.Fatal(err)
}
fmt.Println(data["companyDetailsLookupByNameAddressResult"])
}$body = @'
{
"name": "INTERNATIONAL BUSINESS MACHINES CORPORATION",
"street": "1 NEW ORCHARD RD",
"city": "ARMONK",
"state": "NY",
"zip5": "10504"
}
'@
$response = Invoke-RestMethod -Method Post `
-Uri "https://www.tincomply.com/api/v1/validate/company-details-lookup-by-name-address" `
-Headers @{ "X-API-Key" = "YOUR_API_KEY" } `
-ContentType "application/json" `
-Body $body
$response.companyDetailsLookupByNameAddressResultSample 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