How do I know when a query returns too many buildings?

The response says so with total_is_capped, so you know to narrow the box.

Which assistants work with the MCP server?

ChatGPT, Claude, Cursor and any client that speaks MCP. Every answer links back to the building in the app.

The same buildings, from your code or your assistant.

Query any area through the API with a workspace key, or connect ChatGPT, Claude or Cursor to baseray and ask about buildings in plain language.

Book a demo Open the live map

GET /buildings

curl "https://api.baseray.ai/v1/buildings?bbox=25.55,45.60,25.68,45.70&sort=volume&limit=25&offset=0&category=residential_house&building_type=&roof_shape=gabled&address_corroboration=corroborated&measured_height_only=false&existing_solar_panels=detected&has_solar_potential=false&has_3d_model=false&has_registered_business=false&registered_business_turnover_currency=RON&has_annual_heating_estimate=false&has_thermal_assessment=false&has_peak_heat_load=false&has_recent_climate_trend=false&has_recent_temperature_extremes=false&has_recent_precipitation=false" \
  -H "Authorization: Bearer $BASERAY_API_KEY"

{
  "data": [
    {
      "building_id": "c9eefd1b-8c8d-48fe-8b72-e015374d7720",
      "address": "5th Avenue 120",
      "locality": "Brașov",
      "country": "RO",
      "latitude": 45.64988,
      "longitude": 25.61044,
      "category": "commercial"
    }
  ]

baseray-leads.csv

address	category	footprint_m2	height_m	solar_panels	registered_office
River Road 33	Commercial	17054	18.0	None seen	Registered office
Queen Street 5	Public	11427	~10.0	Not checked
High Street 101	Commercial	11138	3.0	Not checked
Lake View 3	Commercial	9586	~9.0	Not checked
Cedar Lane 27	Industrial	9262	~14.2	Not checked

Build on baseray. The fields you see in the app, wherever you need them.

GET /buildings

curl "https://api.baseray.ai/v1/buildings?bbox=25.55,45.60,25.68,45.70&sort=volume&limit=25&offset=0&category=residential_house&building_type=&roof_shape=gabled&address_corroboration=corroborated&measured_height_only=false&existing_solar_panels=detected&has_solar_potential=false&has_3d_model=false&has_registered_business=false&registered_business_turnover_currency=RON&has_annual_heating_estimate=false&has_thermal_assessment=false&has_peak_heat_load=false&has_recent_climate_trend=false&has_recent_temperature_extremes=false&has_recent_precipitation=false" \
  -H "Authorization: Bearer $BASERAY_API_KEY"

{
  "data": [
    {
      "building_id": "c9eefd1b-8c8d-48fe-8b72-e015374d7720",
      "address": "5th Avenue 120",
      "locality": "Brașov",
      "country": "RO",
      "latitude": 45.64988,
      "longitude": 25.61044,
      "category": "commercial"
    }
  ]

A simple API

Ask for the buildings in a bounding box, sorted and filtered, with a workspace API key created in the app.

Your AI assistant

Connect ChatGPT, Claude, Cursor or any MCP client. It finds buildings, reads their records and saves them to your lead lists.

baseray-leads.csv

address	category	footprint_m2	height_m	solar_panels	registered_office
River Road 33	Commercial	17054	18.0	None seen	Registered office
Queen Street 5	Public	11427	~10.0	Not checked
High Street 101	Commercial	11138	3.0	Not checked
Lake View 3	Commercial	9586	~9.0	Not checked
Cedar Lane 27	Industrial	9262	~14.2	Not checked

The same fields everywhere

The API, the MCP server and the CSV export return the same fields as the app, with unknown values as null, never zero.

Connected in minutes. Three steps.

01

Create a key

Make a workspace API key in the app.
02

Make a request

Query an area, or add the MCP server to your assistant.
03

Use the buildings

Feed them into your systems, or let your assistant save them to a lead list.

Who uses it

API & AI assistants. What it does, and what it does not do yet.

How do I know when a query returns too many buildings?: The response says so with total_is_capped, so you know to narrow the box.
Which assistants work with the MCP server?: ChatGPT, Claude, Cursor and any client that speaks MCP. Every answer links back to the building in the app.

More of the product

Bring baseray to your territory. Tell us your regions and what you sell. We load the data and build your first segments with you.