Developer reference

REST endpoints for the Halden ingestion and reporting platform. All requests require a bearer token.

Base URL

https://api.halden-systems.io/v2

Authentication

curl -H "Authorization: Bearer $TOKEN" \
     https://api.halden-systems.io/v2/datasets

Endpoints

Method	Path	Description
GET	/datasets	List datasets visible to the token
GET	/datasets/{id}	Retrieve dataset metadata
POST	/datasets/{id}/events	Append events, max 500 per batch
GET	/reports/{id}	Fetch a generated report

Rate limits

600 requests per minute per token. Exceeding the limit returns 429 with a Retry-After header. Batch endpoints count as one request regardless of payload size.

Errors

{
  "error": {
    "code": "dataset_not_found",
    "message": "No dataset with that id is visible to this token."
  }
}