API v1

LightSpec AI API

Integrate AI-powered lighting simulation into your website or application. RESTful API with JSON responses — no SDK required.

View EndpointsPricingDashboard

Quick Start

1

Get an API Key

Contact api@auvolar.com or sign up on this page

2

Add the header

X-API-Key: lsk_your_key_here
3

Make a request

curl -X POST https://www.auvolar.com/api/v1/lightspec/recommend \
  -H "Content-Type: application/json" \
  -H "X-API-Key: lsk_your_key_here" \
  -d '{"appType":"warehouse","areaWidth":100,"areaLength":200,"mountingHeight":20}'

Authentication

All API requests require an API key. Pass it via header:

X-API-Key: lsk_your_key_here

Or alternatively:

Authorization: Bearer lsk_your_key_here

Endpoints

POST/api/v1/lightspec/recommend

Recommend Fixtures

AI-powered fixture recommendation with photometric simulation. Returns ranked product matches with scores, fixture counts, and illuminance estimates.

Parameters

NameTypeRequiredDescription
appTypestring✓parking_lot, warehouse, office, roadway, stadium, etc.
areaWidthnumber✓Area width in feet
areaLengthnumber✓Area length in feet
mountingHeightnumber✓Mounting height in feet
targetFcnumber—Target illuminance (fc). Uses IES standard if omitted
cctstring—Color temp preference: 3000, 4000, 5000
retrofitModeboolean—Match existing fixture positions
roadClassstring—CIE 140 road class: M1-M5, P1-P2

Example

curl -X POST https://www.auvolar.com/api/v1/lightspec/recommend \
  -H "Content-Type: application/json" \
  -H "X-API-Key: lsk_your_key_here" \
  -d '{"appType":"parking_lot","areaWidth":200,"areaLength":300,"mountingHeight":25}'
POST/api/v1/lightspec/simulate

IES Simulation

Upload IES file content and room parameters. Returns photometric grid, layout, uniformity metrics, and compliance data.

Parameters

NameTypeRequiredDescription
contentstring✓IES file content (text)
areaWidthnumber✓Area width in feet
areaLengthnumber✓Area length in feet
mountingHeightnumber✓Mounting height in feet
fixtureCountnumber—Override fixture count

Example

curl -X POST https://www.auvolar.com/api/v1/lightspec/simulate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: lsk_your_key_here" \
  -d '{"content":"IESNA:LM-63-2002...","areaWidth":100,"areaLength":200,"mountingHeight":20}'
POST/api/v1/lightspec/parse

Parse IES File

Parse IES/LDT photometric file. Returns beam angles, candela distribution, lamp data, and metadata.

Parameters

NameTypeRequiredDescription
contentstring✓IES file content (text)
fileNamestring—Original filename

Example

curl -X POST https://www.auvolar.com/api/v1/lightspec/parse \
  -H "Content-Type: application/json" \
  -H "X-API-Key: lsk_your_key_here" \
  -d '{"content":"IESNA:LM-63-2002..."}'

API Pricing

Free

$0

20 requests/day

  • ✓ Auvolar product catalog
  • ✓ Basic simulation
  • ✓ JSON response

Starter

$99/mo

100 requests/day

  • ✓ Everything in Free
  • ✓ Priority support
  • ✓ Usage dashboard

Pro

$299/mo

1,000 requests/day

  • ✓ Everything in Starter
  • ✓ White-label PDF reports
  • ✓ Webhook callbacks

Enterprise

Custom

Unlimited

  • ✓ Everything in Pro
  • ✓ Custom product catalog
  • ✓ Dedicated support
  • ✓ SLA guarantee

Ready to get started?

Free tier available — no credit card required. Get your API key instantly.

Request API KeyEnterprise Sales

Response Format

All responses follow a consistent JSON format:

{
  "success": true,
  "data": {
    "matches": [
      {
        "product": { "name": "PLB Series 150W", "sku": "AOK-PLB-150W", "price": 270 },
        "score": 202,
        "fixtureCount": 15,
        "expectedAvgFc": 1.6,
        "reasons": ["Good fixture count range", "Meets illuminance target"]
      }
    ]
  },
  "meta": {
    "api": "LightSpec AI",
    "version": "v1",
    "timestamp": "2026-03-16T15:00:00.000Z"
  }
}