The Location Intelligence API returns two data objects: the location object and the building object.
The resolver additionally returns a resolution object, which explains how a result was reached. It is documented on How to analyze a result.
The location object
A location is one company's operational presence at a physical place. It is returned by the resolver as result, by Get a location by ID, and as each item when listing the locations at a building.
| Field name (key) | Type | Description |
|---|---|---|
| location_id | string | Unique identifier assigned to a location within the Veridion universe. |
| veridion_id | string | Unique identifier assigned to the company operating at this location. Use it to retrieve the full company profile from the Firmographics API. |
| company_name | string | The most commonly used name when referring to the operating company; may either be its legal or commercial name (in some cases, the commercial name is an abbreviation of the company name). |
| location_type | JSON object | The classification of the place, based on the primary business activity carried out on site. It follows Veridion's proprietary taxonomy and is inferred from metadata and address details. It describes the site, not the company. |
| location_type.level_1 | string | The highest level category in the taxonomy, grouping places into broad sectors such as manufacturing, retail, office, logistics, healthcare, or agriculture. |
| location_type.level_2 | string | The mid level category under level 1, providing a more specific functional grouping based on the activity carried out on site. For example, Warehouse under Logistics, or Farm under Agriculture, Forestry & Fishing. |
| location_type.level_3 | string | The most specific category in the taxonomy, identifying the detailed operational subtype within level 2. For example, Crop Farm within Farm, or Hazardous Materials Storage within Specialized Storage Facility. |
| address | JSON object | The address of the location. Only country_code and country are guaranteed. |
| address.country_code | string | The two-digit ISO code of the country in which the location sits. |
| address.country | string | The country name associated with the location. |
| address.region | string | The region name associated with the location. |
| address.city | string | The city associated with the location. |
| address.postcode | string | The postal code associated with the location. |
| address.street | string | The street name associated with the location. |
| address.street_number | string | The street number associated with the location. |
| address.address_line | string | The first line of the street address, typically containing the street number and street name. When available, it may also include building, complex, block, or unit identifiers associated with the location. |
| address.latitude | decimal | The latitude coordinates associated with the location. |
| address.longitude | decimal | The longitude coordinates associated with the location. |
| naics_2022 | JSON object | Classification of the business activity performed on site, using the official NAICS 2022 taxonomy at 6-digit granularity. |
| naics_2022.code | string | NAICS 2022 classification code. |
| naics_2022.label | string | NAICS 2022 classification label. |
| employee_count | JSON object | The number of people employed on site, either extracted from the digital sources Veridion gathers data from, or modelled using proprietary ML algorithms. This is the headcount at this place, not across the company. |
| employee_count.value | integer | The number of people employed on site. |
| employee_count.type | string | "Extracted" for values published in sources used by Veridion. "Modelled" for values generated by Veridion's proprietary algorithms. |
| revenue | JSON object | Yearly revenue generated on site, in USD. This is the revenue attributable to this place, not to the company as a whole. |
| revenue.value | integer | Yearly revenue generated on site, in USD. |
| revenue.type | string | "Extracted" for values published in sources used by Veridion. "Modelled" for values generated by Veridion's proprietary algorithms. |
| building | JSON object | The structure the location occupies, in nested form. null where the location has no building, which happens when the address could not be resolved precisely enough to identify one, when no footprint is available, or when the place genuinely has no structure, as with a solar farm or a substation. Omitted entirely when listing the locations at a building, because the building is already identified by the request. |
| building.building_id | string | Unique identifier associated with the building structure. Pass it to Get a building by ID for the structure's physical detail. |
| building.occupant_count | integer | The number of business locations associated with the building. A count above one means the structure is shared. |
The building object
A building is a physical structure, and it can be associated with many locations. The full object is returned by Get a building by ID. Locations carry only the nested form described above.
| Field name (key) | Type | Description |
|---|---|---|
| building_id | string | Unique identifier associated with the building structure. |
| building_name | string | The name of the building, if available. |
| building_subtype | string | Broad classification indicating the general purpose or function category of the building. |
| building_class | string | Further categorization describing the specific functional purpose or use of the building. |
| height_m | decimal | Height of the building, in meters. |
| area_m2 | decimal | Total area of the building footprint, in square meters. |
| num_floors | integer | Number of floors in the building. |
| geometry_wkt | string | The building footprint as a polygon, in WKT format. |
| bbox_xmin | decimal | Minimum x-coordinate (longitude) of the building's bounding box, derived from the polygon geometry. |
| bbox_xmax | decimal | Maximum x-coordinate (longitude) of the building's bounding box, derived from the polygon geometry. |
| bbox_ymin | decimal | Minimum y-coordinate (latitude) of the building's bounding box, derived from the polygon geometry. |
| bbox_ymax | decimal | Maximum y-coordinate (latitude) of the building's bounding box, derived from the polygon geometry. |
| occupant_count | integer | The number of business locations associated with the building. To retrieve the businesses themselves, use Get locations at a building. |