Skip to content

A building data API for Romania.

One record per building for any area in Romania, over REST, with every estimate marked as one.

One building. The documented example response of the building endpoint.

Create an API key in the app under Settings → API keys. Each key may make 60 requests a minute; a workspace 5,000 a day.

Request
curl "https://api.baseray.ai/v1/buildings/c9eefd1b-8c8d-48fe-8b72-e015374d7720" \
  -H "Authorization: Bearer $BASERAY_API_KEY"
Response
{
  "data": {
    "building_id": "c9eefd1b-8c8d-48fe-8b72-e015374d7720",
    "address": "Bulevardul 15 Noiembrie 78",
    "locality": "Brașov",
    "country": "RO",
    "latitude": 45.64988,
    "longitude": 25.61044,
    "category": "commercial",
    "footprint_area_m2": 31252,
    "height": {
      "metres": 18,
      "basis": "estimated"
    },
    "volume_m3": 562531,
    "volume_basis": "estimated",
    "floors": 16,
    "existing_solar_panels": {
      "status": "none_seen",
      "photo_date": "2022-09-08",
      "confidence": 0.988
    },
    "solar_potential": null,
    "registered_business_count": 0,
    "app_url": "https://app.baseray.ai/?building=c9eefd1b-8c8d-48fe-8b72-e015374d7720",
    "dwellings": null,
    "entrances": null,
    "is_current": true,
    "replaced_by_building_id": null
  }
}

What the API returns. Every value is a fact or null, and estimates say so.

Buildings in an area

Address where one is on record, category, footprint, height and volume, floors, dwellings and entrances where known.

Measured or estimated

Every height and volume says how it was obtained.

Existing solar panels

Detected, none seen or unclear, with the date of the photo, and the roof’s solar potential where it has been modelled.

Registered businesses

Businesses whose registered office is the building’s exact official address, with their CUI. Never ownership or occupancy.

From a key to your first buildings. Three steps.

  1. 01

    Create a key

    In the app, under Settings → API keys.

  2. 02

    Send a request

    GET /v1/buildings with an area, a sort and a limit, or one building by its id. Everything is in the API reference.

  3. 03

    Or ask in a chat

    Through the MCP server, ask about buildings in ChatGPT or Claude.

API questions. What the record holds, and what it does not yet.

Does the API cover all of Romania?

Yes, every county. Each building has a record; values that are not known are null rather than guessed.

Does it return the construction year or cadastral number?

Not yet; the app shows them where known. For legal or notarial use, the official document is the land book extract from ePay ANCPI.

Can I use it from ChatGPT or Claude?

Yes, through the baseray MCP server. The MCP docs have setup steps per client.

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