REST API v1 reference

/api/v1/* er qlim8's public REST API. Auth via Bearer-tokens (apiKeys-tabellen). Cursor-pagineret, RFC 7807-fejlformat, OpenAPI 3.1-spec eksponeret. Routerne ligger i server/v1/ opdelt i 14 sub-moduler. Tier-gates pr. endpoint via subscriptionFeatures.ts.

Auth: Authorization: Bearer <key>; Keys er præfixet (fx tk_live_…).
Errors: application/problem+json (RFC 7807)
Rate-limit: Delt bucket med MCP, 100 req/min pr. key
Pagination: limit (default 20, max 100), cursor (base64-keyset)

Indholdsfortegnelse

Identity & keys Emissions & activities Factors & lineage Audit Suppliers (Enterprise)Reduktionsmål Tenant Reports (async)Webhooks Admin (super-admin)OpenAPI

Identity & keys

GET	/v1/me	Aktuel API-key-holder + tenant.
POST	/v1/api-keys	Opret ny nøgle (tenant eller 3.-part).
GET	/v1/api-keys	List nøgler.
DELETE	/v1/api-keys/{id}	Tilbagekald.

Emissions & activities

GET	/v1/emissions	List emission-entries (cursor-pagineret).
GET	/v1/emissions/{id}	Enkelt entry.
GET	/v1/activities	List activities (filtre: dato, dataSource).
GET	/v1/activities/{id}	Enkelt activity.

Factors & lineage

GET	/v1/factors	Tilgængelige faktorer (DK + EXIOBASE).
GET	/v1/factors/{id}	Enkelt faktor + citations.
GET	/v1/lineage/{emissionEntryId}	Fuld beregnings-lineage.

Audit

GET

/v1/audit

Suppliers (Enterprise)

Kræver Enterprise-tier med supplyChain-feature.

GET	/v1/suppliers	List supplier-connections.
POST	/v1/suppliers/{id}/invite	Invitér til datadeling.
GET	/v1/suppliers/{id}/allocation	Supplier-specifik allokering.

Reduktionsmål

GET	/v1/targets	List mål.
POST	/v1/targets	Opret mål.
GET	/v1/targets/{id}/progress	Progress-tracking.

Tenant

GET	/v1/tenant	Aktuel tenant-metadata.
PUT	/v1/tenant	Opdatér tenant-settings.

Reports (async)

POST	/v1/reports	Start rapport-generation (VSME, CSRD).
GET	/v1/reports	List genererede rapporter.
GET	/v1/reports/{id}	Rapport + download-URL.
GET	/v1/reports/{jobId}/status	Job-status.

Webhooks

POST	/v1/webhooks	Opret subscription.
GET	/v1/webhooks	List.
DELETE	/v1/webhooks/{id}	Slet.
POST	/v1/webhooks/{id}/test	Send test-event.
POST	/v1/webhooks/{id}/replay	Replay fejlet leverance.
GET	/v1/webhooks/{id}/deliveries	Delivery-audit.

Admin (super-admin)

GET

/v1/admin/metrics

OpenAPI

GET

/v1/openapi.json

Kendte begrænsninger

— Ingen versionering ud over /v1 — breaking changes kræver /v2.
— Cursor-pagineret kun — ingen offset-pagination.
— Bulk-operations mangler (fx batch-opret aktiviteter).
— Rate-limit pr. tenant, ikke pr. nøgle — én nøgle kan udmatte hele tenant-bucketet.

Roadmap

— /v1/activities batch-POST.
— GraphQL-alternative for kompleks aggregation (under afvejning).
— Per-key rate-limit.
— Webhook-replay-bulk via filtre.

Foretrækker du JSON-RPC og agent-tools?

Hvert REST-endpoint har et tilsvarende MCP-tool. Samme auth, samme rate-limits, optimeret til AI-agenter.

MCP Quickstart →Tool reference →