Get a building by ID

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Retrieves a physical structure by its Veridion building ID.

This is the only endpoint that returns the full building object. A resolved or retrieved location carries only the building's ID and its occupant count, so this is where the rest of the physical detail lives.

Run in Postman



What this endpoint does not return

The businesses operating in the building, only their count. To retrieve the occupants themselves, use Get locations at a building.

📘

Building presence

Not every location has a building. A building is not attached when the address could not be resolved with enough specificity, when no footprint could be established, or when the site has no structure to speak of, such as a solar farm or a remote industrial asset.

In those cases the location's building is null and there is no ID to look up.

Successful response

A successful request returns 200 OK with the building object, returned directly rather than wrapped in an envelope.

📖

Response fields

For a comprehensive list of all data points returned on a building, see the Response fields and types page.

Error responses

  • 404 Not Found, if no building exists for the given ID.
  • other standard HTTP error responses, detailed in the Response codes section.

Any error response follows a specific structure. Please see the Error response format section for more details.

Path Params
string
required

The Veridion ID of the building.

Responses

Language
LoadingLoading…
Response
Choose an example:
application/json