DeaMap/API Docs

DeaMap Public API

Free REST API to query AED (defibrillator) locations across Spain. No authentication required.

v1.0REST / JSONNo Auth Required

Quick Start

Find the 5 nearest defibrillators to Madrid city center:

curl "https://deamap.es/api/v1/aeds/nearby?lat=40.4168&lng=-3.7038&limit=5"

CORS Enabled

Access from any origin. Use directly from browser-based applications.

Rate Limited

60 requests per minute per IP. Responses include cache headers.

OpenAPI Spec

Full OpenAPI 3.1 specification for code generation and tooling.

Base URL

https://deamap.es/api/v1

Endpoints

GET/api/v1/aeds/nearby

Find the nearest AEDs to a geographic coordinate

Parameters: lat, lng (required), radius, limit (optional)

GET https://deamap.es/api/v1/aeds/nearby?lat=40.4168&lng=-3.7038&radius=2&limit=5
GET/api/v1/aeds/{id}

Get detailed information about a specific AED

Parameters: id (UUID, required)

GET https://deamap.es/api/v1/aeds/550e8400-e29b-41d4-a716-446655440000
GET/api/v1/aeds/city/{city}

Get all AEDs in a city with pagination

Parameters: city (required), limit, offset (optional)

GET https://deamap.es/api/v1/aeds/city/Madrid?limit=50
GET/api/v1/aeds/stats

Get global statistics: total AEDs, cities, and top cities

Parameters: None

GET https://deamap.es/api/v1/aeds/stats

Response Format

All responses follow a consistent structure:

{
  "data": [ ... ],     // Array or object with results
  "meta": {
    "total": 10,       // Result count
    "api_version": "v1"
  }
}

Error responses include error and message fields.

Rate Limiting

The API is limited to 60 requests per minute per IP address. Exceeding this limit returns a 429 status with a Retry-After header.

Responses include Cache-Control headers. Please cache responses when possible to reduce API calls.

LLM / AI Integration

This API is designed to be easily consumed by AI assistants and large language models:

Back to DeaMap