---
title: "Atlasly API Reference — Site Intelligence Endpoints"
description: "REST API reference for Atlasly — site analysis, compliance check, walkability, flood zone, exports. 100 calls/month on Pro, 1,000 on Teams, custom on Enterprise."
canonical: https://atlasly.app/resources/api
primary_keyword: "Atlasly API reference"
target_query: "Atlasly API documentation endpoints"
intent: navigational
---

# Atlasly API Reference

> Complete REST API for embedding Atlasly's 17-step site intelligence pipeline into your product.

## Quick Answer

**How do I call the Atlasly API?** `POST https://api.atlasly.app/v1/site-analysis` with `Authorization: Bearer <API_KEY>` and body `{"address": "SW1A 1AA"}`. Returns the full site intelligence output as JSON plus signed URLs for CAD/BIM/PDF exports.

## Authentication

All requests require a Bearer token:

```
Authorization: Bearer sk_atlasly_...
```

Generate your API key at https://atlasly.app/profile → API Keys.

## Endpoints

### POST /api/v1/site-analysis
Run the full 17-step pipeline for an address or boundary.

**Request:**
```json
{
  "address": "10 Downing Street, London",
  "radius_km": 0.5
}
```
or
```json
{
  "boundary": { "type": "Feature", "geometry": { ... } }
}
```

**Response:** Complete site intelligence JSON with planning, flood, heritage, ecology, topography, transport, microclimate, buildings, land registry, plus signed `exports` URLs for DXF / DWG / GLB / IFC / PDF.

### GET /api/v1/site/:id
Retrieve a cached site result by ID. Zero-quota cost for cached sites within 30 days.

### GET /api/v1/site/:id/export/:format
Download a specific export format. Formats: `dxf`, `dwg`, `skp`, `glb`, `obj`, `fbx`, `stl`, `dae`, `ifc`, `geojson`, `shp`, `svg`, `csv`, `pdf`.

### POST /api/v1/compliance/check
NPPF + local plan compliance scan on a proposal.

**Request:**
```json
{
  "site_id": "...",
  "proposal": "Five-storey residential, 40 units, 20% affordable"
}
```

### POST /api/v1/walkability
15-minute city score alone (without full pipeline).

### POST /api/v1/flood
Flood-only endpoint — EA zones + surface water risk.

### GET /api/v1/usage
Your current API call quota usage.

## Rate Limits

- **Pro (£14.99/mo)**: 100 monthly calls, 10 concurrent
- **Teams (£49.99/mo)**: 1,000 monthly calls, 20 concurrent
- **Enterprise**: custom

Cached site retrievals do not count against quota.

## Webhooks

Configure a webhook URL per API key to receive completion events:

```json
{
  "event": "site_analysis.completed",
  "site_id": "...",
  "timestamp": "2026-04-19T12:00:00Z",
  "result_url": "https://api.atlasly.app/v1/site/..."
}
```

## SDKs

- **JavaScript / TypeScript**: `npm install @atlasly/sdk`
- **Python**: on request
- **Other languages**: use any HTTP client against the REST API

## Error Handling

- `400` — invalid request body
- `401` — missing or invalid API key
- `403` — plan does not include API access (upgrade to Pro)
- `429` — quota exceeded (check `/v1/usage`)
- `500` — internal pipeline error (retry; contact support if persists)

All errors return:
```json
{ "error": { "code": "...", "message": "..." } }
```

## Caching Behaviour

- Full pipeline results cached 30 days per account
- Repeat calls for the same address hit the cache at zero quota cost
- Force re-run with `?fresh=true` query parameter

## Support

- Email: hello@atlasly.io
- Status: https://atlasly.app/resources/status
- Full docs: https://atlasly.app/resources/docs

## Links

- Pricing: https://atlasly.app/pricing
- API Integration solution page: https://atlasly.app/solutions/api-integration
- Blog on batch screening: https://atlasly.app/blog/site-analysis-api-for-architecture-firms-batch-screening-sites-without-building-another-internal-tool