Utvecklare

API – v1

REST-API och webhooks för integration mot GFLkollen. För lönesystem (Hogia, Visma, Flex), fackförbund och bemanningsföretag med egna interna system.

Bearer-auth + HMAC
Rate limit 1 000/min
JSON over HTTPS
OpenAPI 3.1

Base URL

https://api.gflkollen.se/v1

Autentisering via Authorization: Bearer <din-nyckel>. Skapa nyckel under Inställningar → API-nycklar.

Kollektivavtal (öppna)

GET
/api/public/v1/agreements
öppen

Lista alla kollektivavtal med delningstal och skiftformer.

GET
/api/public/v1/agreements/{id}/rates
öppen

Hämta ersättningssatser (OB, övertid, ATF) för ett avtal.

GFL-underlag (B2B)

POST
/api/public/v1/submissions
bemanningsföretag

Skapa nytt GFL-underlag programmatiskt från lönesystem.

GET
/api/public/v1/submissions/{id}
bemanningsföretag

Hämta status och innehåll på ett inskickat underlag.

GET
/api/public/v1/submissions
bemanningsföretag

Lista underlag med filter (datum, status, avtal, kund).

Facklig signering

GET
/api/public/v1/union/pending
fack-token

Lista underlag som väntar facklig granskning för ert avtalsområde.

POST
/api/public/v1/union/submissions/{id}/sign
fack-token

Signera (godkänn) eller flagga avvikelse på ett underlag.

Statistik (anonymiserad)

GET
/api/public/v1/stats/wages
api-nyckel

Aggregerad lönestatistik. Query: agreement, role, region. k-anonymitet ≥ 3.

Webhooks

POST
/api/public/v1/webhooks
api-nyckel

Registrera webhook-URL för events. HMAC-signerad payload.

Webhook-events

submission.createdNytt GFL-underlag har skickats in.
submission.signedFacklig representant har signerat underlaget.
submission.flaggedAvvikelse har flaggats av facket eller granskare.

OpenAPI-spec

Full maskinläsbar specifikation för kodgenerering (TypeScript, Python, Go).

⚠️ API-skelet under utveckling. Endpoints listade ovan reflekterar planerad v1-yta – kontakta oss för early access.