canonical: https://jentic.com/apis/baseray.ai/baseray

# baseray API

The baseray API gives read access to a catalogue of buildings in Romania and Czechia. For each building it returns footprint, height, volume, floor area, floors, category, address and postcode, flood zone and seismic risk, construction year, rooftop solar potential, and whether solar panels are already installed. It also lists the businesses whose registered office is at a building's address, and serves public address search, place statistics, and a company directory.

## For AI agents

Look up buildings in Romania and Czechia by area, point, or id and read their physical, risk, and solar attributes, plus the businesses registered at an address. Returns JSON over a bearer-authenticated REST API with public lookup endpoints.

## Scope

Does not list properties for sale, run valuations, or book viewings. Use for reading building attributes, addresses, and registered businesses in Romania and Czechia only.

## Capabilities

- Look up buildings in an area or at a point with footprint, height, volume, and floor data
- Read a building's record including construction year, flood zone, and seismic risk
- Return rooftop solar potential and whether panels are already installed for a building
- List the businesses registered at a building's address
- Search addresses and read building statistics for a place or county directory

## Use cases

### AI Agent Building Data Integration via Jentic

An agent that enriches an address or coordinate with building facts can call baseray through Jentic without wiring the bearer key or splitting public from authenticated lookups. The agent searches by intent, receives the operation schema, and reads a building's attributes as structured JSON. This fits property, insurance, and energy agents working in Romania and Czechia.

Example prompt: Search Jentic for 'look up a building', load the operation schema, and read a building's attributes for a coordinate

### Building Attribute Lookup

Resolve a coordinate or id to a building and read its physical and risk attributes. baseray returns footprint, height, volume, floor area, floors, category, flood zone, seismic risk, and construction year, so an agent can describe or assess a specific structure from one record.

Example prompt: Call GET `/buildings/at` with a coordinate to get the building at that point, then GET `/buildings/{building_id}` for its full record

### Registered Business Resolution

Find which companies have their registered office at a building's address. baseray lists the registered businesses for a building, letting a due-diligence or sales agent connect a physical address to the organisations tied to it.

Example prompt: Call GET `/buildings/{building_id}/registered-businesses` to list the businesses at a building's address

### Rooftop Solar Assessment

Judge a building's suitability for solar from its record. baseray reports rooftop solar potential and whether panels are already installed, alongside the roof-relevant geometry, so an energy agent can shortlist candidate roofs across an area before a site visit.

Example prompt: Call GET `/buildings/{building_id}` and read the rooftop solar potential and panel status from the record

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/buildings` | Buildings in an area, ranked |
| GET | `/buildings/at` | Buildings at a point |
| GET | `/buildings/{building_id}` | One building's full record |
| GET | `/buildings/{building_id}/registered-businesses` | Businesses registered at a building's address |
| GET | `/public/address-search` | Address check |
| GET | `/public/places/{country}/{slug}/stats` | A place's building statistics |
| GET | `/public/directory/{country}/{trade}/{county_slug}` | Companies of a trade in a county |

## Key resources

- **Buildings** — Ranked area search, point lookup, and a building's full record
- **Registered businesses** — Companies registered at a building's address
- **Public building pages** — Public building records, previews, and listings
- **Places and directory** — Address search, place statistics, and company directory by trade and county

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 66 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 74 / 100
  - Developer Experience & Jentic Compatibility: 71 / 100
  - AI-Readiness & Agent Experience: 49 / 100
  - Agent Usability: 94 / 100
  - Security: 60 / 100
  - AI Discoverability: 75 / 100
- **View full report:** https://jentic.com/apis/baseray.ai/baseray/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the baseray API by hand means managing its bearer key, calling the right buildings or public lookup, and handling the public endpoints that need no key. Through Jentic you install once, import baseray from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** baseray puts the building id in the URL path (`/buildings/{building_id}`), so a rule can pin your agent to building reads for the ids you allow. You choose the operations it may call, and because every endpoint is read-only it can fetch records and registered businesses while nothing is changed.
- **Credential handling:** Your baseray API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'look up a building' or 'list businesses at an address', and Jentic returns the matching baseray operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **ATTOM Property API** — Alternative property and building attribute data (US coverage)
- **Zillow Property Data** — Alternative residential property data and attributes
- **Regrid Parcel API** — Parcel boundaries and geocoding

## FAQ

### Is there a baseray MCP server?

You don't need a separate MCP server to give your agent the baseray API. Jentic connects it directly from the API Directory: import it, store your bearer key once, and your agent calls the building and address lookup operations it needs.

### Can I limit what my agent is allowed to do with the baseray API?

Yes. baseray is read-only, and the building id sits in the URL path, so you write a rule that allows building record and registered-business reads and the agent can fetch those while anything else stays out of reach. Every call is logged by your self-hosted instance.

### What authentication does the baseray API use?

The baseray API authenticates with a bearer workspace API key sent in the Authorization header, per its OpenAPI spec. Public endpoints such as the building pages, address search, and directory need no credential, while the ranked building lookups require the key. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at call time.

### Can I get flood-zone and solar data for a building with the baseray API?

Yes. A building's record includes its flood zone, seismic risk, rooftop solar potential, and whether panels are already installed, alongside footprint, height, volume, and floor data. You fetch it by building id or by resolving a coordinate first.

### What are the rate limits for the baseray API?

The OpenAPI spec does not specify rate limits. Check the vendor's documentation at https://baseray.ai for current limits and plan tiers.

### How do I look up a building with the baseray API through Jentic?

Search Jentic for 'look up a building' and it returns the baseray lookup operation with its input schema; supply a coordinate or id and the agent reads the building's attributes as structured JSON. To run it on your own infrastructure, install Jentic One from its GitHub repo.