API reference

Base URL: https://damos.orcahq.co.uk
Auth: send Authorization: Bearer dl_xxx with a token from your dashboard, or sign in via the web UI to use a session cookie.

GET /api/identify

Identify an ECU by hardware number.

curl "https://damos.orcahq.co.uk/api/identify?hw_number=0281020113" \
    -H "Authorization: Bearer $DAMOS_TOKEN"

POST /api/identify-binary

Upload a binary read; we extract candidate signatures and match against the index.

curl -X POST "https://damos.orcahq.co.uk/api/identify-binary" \
    -H "Authorization: Bearer $DAMOS_TOKEN" \
    -F "file=@unknown_read.bin"

Free tier: max 1MB. Personal+: max 16MB.

GET /api/maps

List maps for a specific indexed file.

curl "https://damos.orcahq.co.uk/api/maps?file_id=12345&limit=100" \
    -H "Authorization: Bearer $DAMOS_TOKEN"

GET /api/maps/by-category paid

List maps in a category across the entire archive.

curl "https://damos.orcahq.co.uk/api/maps/by-category?category=fuel&ecu_family=EDC17" \
    -H "Authorization: Bearer $DAMOS_TOKEN"

Categories: fuel, torque, diagnostics, lambda, rail_pressure, EGR, thermal, speed_limiter, ignition, boost, cold_start, DPF, other

GET /api/files/{file_id}/download paid

Download the matched A2L file (or other indexed source).

curl -OJ "https://damos.orcahq.co.uk/api/files/12345/download" \
    -H "Authorization: Bearer $DAMOS_TOKEN"

GET /api/search

Free-text search across files and map names.

curl "https://damos.orcahq.co.uk/api/search?q=N57" \
    -H "Authorization: Bearer $DAMOS_TOKEN"

GET /api/stats

Public — archive coverage stats.

curl "https://damos.orcahq.co.uk/api/stats"

Rate limits

A 429 response carries Retry-After: 86400. Quotas reset at 00:00 UTC.