The Location Intelligence API tells you where companies operate, and what those places are.
It has two entry points. Start from an address and the API tells you which business operates there. Start from a company and it tells you every place that company operates. From either, you can retrieve the physical structure a place sits in, and everyone else operating inside it.
Company footprint is coming soonListing every location of a company is in development and not yet available. Everything else described on this page is live today: resolving an address, retrieving a location or a building by ID, and listing the businesses inside a building.
References to listing a company's locations are marked below so you can tell what is available now.
What a location isA location is one company's operational presence at a physical place. It is not the address on its own, and it is not the company profile. It is the site level record of what a company operates at that place: its activity, its size, and the structure it occupies (where available).
How companies, locations, and buildings relate
Three entities, connected but distinct.
| Entity | What it is |
|---|---|
| Company | The business. Identified by a veridion_id. |
| Location | One operational presence of that company at a physical place. Identified by a location_id. |
| Building | A physical structure. Identified by a building_id. |
The relationships between them are what shape every response:
- A company has at least one location, and often many.
- A location belongs to exactly one company. Two businesses at the same address are two locations, not one shared record.
- A location has zero or one building.
- A building can hold many locations, which is what makes shared occupancy visible.
Why a location may have no buildingA location's
buildingisnullwhen there is no structure to attach. This happens when the address could not be resolved precisely enough to identify one, when no footprint is available for it, or when the place genuinely has no building, as with a solar farm, a substation, or a remote industrial asset.A location without a building is still a complete location. It has an address, coordinates, an activity classification, and size data. Only the physical structure is missing.
Address detail also varies by location. Most carry full street level coordinates, but some are known only to city level, which limits how precisely they can be matched or mapped.
What counts as a location
A location is any place where a company operates, staffed or unstaffed. This goes well beyond offices:
- offices and corporate headquarters;
- retail stores and restaurants;
- warehouses and distribution centers, including automated ones;
- factories and plants;
- onshore solar and wind farms, and substations;
- gas stations, construction sites, and other unstaffed facilities.
Every location is classified against a three level taxonomy, from a broad category down to a specific facility type. For example, a solar farm is classified as Energy & Utilities, then Renewable Energy Generation, then Solar Farm. Not every location resolves to all three levels, so the second and third can be null.
Operational presence, not legal registrationThe API reports where a company actually operates. A registered address, a mailing address, or a legal seat is not a location, and is never returned as one.
This is the core distinction from registry and firmographic data, which anchor a company to its legal or headquarters address rather than to each site it runs.
Company data lives elsewhere
Every location carries the operating company's veridion_id and name, but not the company record itself. Full company data is retrieved from the Firmographics API using that ID.
The Location Intelligence API references companies. It does not return company profiles.
Which endpoint to use
| What you have | What you want | Use |
|---|---|---|
| An address | The business operating there | Location Resolver |
| A company | Every place it operates | List a company's locations (coming soon) |
| A location ID | That location's full record | Get a location by ID |
| A building ID | The structure's physical detail | Get a building by ID |
| A building ID | Every business inside it | Get locations at a building |
Putting the calls together
Confirm a company operates at an address, then enrich the site. Resolve the address with the company name supplied. A confirmed match returns the location with its activity, size, and building reference in a single call.
See who shares a site. Resolve an address, take the building ID from the response, then list the locations at that building. This is what makes shared exposure and supplier concentration visible, since neither is detectable from an address alone.
Map a company's whole footprint (coming soon). List the company's locations, then retrieve individual locations or their buildings where you need more detail.