canonical: https://jentic.com/apis/lightboxre.com/lightboxre

# Lightboxre LightBox Renewable Energy API

Jentic publishes the only available OpenAPI specification for LightBox Renewable Energy API, keeping it validated and agent-ready. The LightBox Renewable Energy API delivers parcel and property data tailored to renewable-energy site selection, exposing solar potential and energy profiles for US properties alongside parcel boundaries. Five endpoints cover property search, property detail, solar potential, energy profile, and parcel search. Authentication uses an API key supplied in the X-API-Key header.

## For AI agents

Look up US property and parcel data with solar potential and energy profile lookups via 5 API-key-authenticated endpoints.

## Scope

Does not handle solar panel installation, electricity-grid interconnection, or renewable financing - use for US property and parcel data with solar and energy attributes only.

## Capabilities

- Search US properties by address, owner, or location bounding box for renewable-energy site selection
- Retrieve detailed property records including ownership, size, and zoning attributes
- Calculate solar potential for a specific property to support solar-installation feasibility studies
- Pull energy-profile data for a property including consumption and generation indicators
- Search parcel boundaries to identify land suitable for utility-scale renewable development

## Use cases

### Solar Site Feasibility

Score US properties for rooftop or ground-mount solar feasibility by combining solar potential, energy profile, and parcel data. The `/properties/{propertyId}/solar-potential` endpoint returns site-level irradiance and array sizing inputs. Solar developers replace days of GIS work with API-level scoring in minutes.

Example prompt: Fetch solar potential for property ID 'prop-9981' and report estimated annual generation

### Utility-Scale Land Sourcing

Search parcels by location and zoning attributes to identify candidate sites for utility-scale solar or wind projects. The /parcels endpoint exposes parcel boundaries and ownership so origination teams can build a long-list of candidate sites without GIS infrastructure.

Example prompt: Search parcels in county 'Kern, CA' with parcel size over 100 acres and return ownership records

### Energy Profile Lookups for Underwriting

Project finance and underwriting workflows need consistent energy-profile data per property. The `/properties/{propertyId}/energy-profile` endpoint returns profile attributes consumable by financial models. Replaces manual utility-bill collection with API-level data.

Example prompt: Pull the energy profile for property ID 'prop-2233' and forward it to the underwriting model

### AI Agent Site-Selection Assistant

An AI agent uses Jentic to search properties, score solar potential, and identify candidate parcels in a target US county. The agent composes the property-search and solar-potential endpoints to produce a ranked shortlist. Credentials are isolated through Jentic so the LightBox API key never enters the agent's prompt.

Example prompt: Search Jentic for 'find properties with high solar potential', load the property-search and solar-potential schemas, and produce a top-10 ranked shortlist

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/properties` | Search US properties by address, owner, or location |
| GET | `/properties/{propertyId}` | Get full property record by ID |
| GET | `/properties/{propertyId}/solar-potential` | Get solar-potential metrics for a property |
| GET | `/properties/{propertyId}/energy-profile` | Get energy-profile attributes for a property |
| GET | `/parcels` | Search parcel boundaries for site sourcing |

## Key resources

- **Properties** — Search and retrieve US property records with solar and energy attributes
- **Parcels** — Search parcel boundaries and ownership for site sourcing
- **Renewable Energy** — Solar potential and energy profile lookups attached to property IDs

## Why Jentic

- **Setup:** Wiring the LightBox Renewable Energy API by hand means setting its X-API-Key header, learning which endpoints return property, parcel, solar, and energy data, and calling api.lightboxre.com yourself. Through Jentic you install once, import the LightBox Renewable Energy API from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** LightBox puts the property id in the URL path (`/properties/{propertyId}/solar-potential`, /energy-profile) on read-only endpoints, so a rule can pin your agent to reading one property and its solar and energy attributes. You choose the operations it may call, so it stays within the reads you allow.
- **Credential handling:** Your LightBox 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 'find properties with high solar potential', and Jentic returns the matching LightBox operation with its input schema and required header so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **RentCast** — US property and rental data, lighter on renewable-specific attributes
- **ATTOM Data Property API** — Broad US property and parcel dataset for due-diligence workflows
- **Clearbit** — Enrich property owner records with company-firmographic data

## FAQ

### Why is there no official OpenAPI spec for LightBox Renewable Energy API?

LightBox does not publish a maintained OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call the LightBox Renewable Energy API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the LightBox Renewable Energy API use?

It uses an API key supplied in the X-API-Key header. Through Jentic, the API key is stored in your Jentic One instance and injected per request - the raw key never enters the agent's prompt or memory.

### Can I get solar potential for any US property?

Solar potential is available via `/properties/{propertyId}/solar-potential` for properties in LightBox's coverage. First call /properties to resolve an address or owner to a property ID, then request solar potential by that ID.

### What are the rate limits for the LightBox Renewable Energy API?

Rate limits vary by LightBox subscription tier and are not encoded in the spec. Production accounts typically get higher per-minute quotas; on HTTP 429 the agent should back off and retry with exponential delay.

### How do I score a property for solar feasibility through Jentic?

Run pip install jentic, then search Jentic with 'get solar potential for a property' to retrieve the `/properties/{propertyId}/solar-potential` operation schema. Execute it with the property ID; Jentic handles the X-API-Key automatically.

### Is the LightBox Renewable Energy API free?

No. LightBox sells subscription access to its property and renewable-energy datasets. Pricing depends on coverage and call volume; contact LightBox for a quote.

### Can I limit what my agent is allowed to do with the LightBox Renewable Energy API?

Yes. Because you run Jentic One yourself, your own rules decide which LightBox operations and credentials the agent may use. All five LightBox endpoints are read-only GET calls, so you can allow only the reads you want, such as property search on /properties while blocking parcel search on /parcels. Since the property id sits in the path on `/properties/{propertyId}/solar-potential` and `/properties/{propertyId}/energy-profile`, you can pin the agent to reading a single property and its solar and energy attributes.