API-referanse

Spire API v1

REST over HTTPS, JSON inn og ut, datoversjonert. Basisadresse https://api.spireapi.com i produksjon og https://sandkasse.spireapi.com i sandkassen. Alle tidspunkter er ISO 8601 i UTC, alle beløp er desimaltall i hele kroner og øre.

Autentisering

Send API-nøkkelen som Bearer-token. Nøkler som begynner med sk_test_ virker bare mot sandkassen, sk_live_ bare mot produksjon. Les mer under autentisering.

hoder

Authorization: Bearer sk_live_…
Spire-Version: 2026-09-01
Idempotency-Key: ordre-10422       # bare POST
Content-Type: application/json

Svarformat

Enkeltobjekter returneres direkte. Lister returneres som { "data": [...], "neste": "markør" } der neste er null på siste side. Alle svar har hodene Spire-Request-Id, Spire-Version og RateLimit-Remaining.

Feil

Feil har alltid samme form. Se alle feilkoder.

400 Bad Request

{
  "feil": {
    "kode": "ugyldig_parameter",
    "melding": "orgnr må være nøyaktig ni sifre.",
    "felt": "orgnr",
    "dok": "https://spireapi.com/api/feil/#ugyldig_parameter",
    "request_id": "req_01JBX9W2K4"
  }
}

Endepunkter

Virksomheter (Oppslag)

Søk og oppslag i norske virksomheter, roller, regnskap og konsernstruktur.

GET/v1/virksomheter
GET/v1/virksomheter/{orgnr}
GET/v1/virksomheter/{orgnr}/roller

Fakturaer

Opprett, send og følg opp fakturaer. Kreditnota, innbetalinger og innboks for mottatte EHF-fakturaer.

POST/v1/fakturaer
POST/v1/fakturaer/{id}/send
GET/v1/fakturaer/{id}

Signeringer

Send dokumenter til signering, følg status per part og hent signert PDF.

POST/v1/signeringer
GET/v1/signeringer/{id}
GET/v1/signeringer/{id}/dokument

Meldinger (Varsling)

Send SMS, e-post og push, enkeltvis eller i batch, med maler og leveringsstatus.

POST/v1/meldinger
GET/v1/meldinger/{id}
POST/v1/meldinger/batch

Adresser

Søk, validering, geokoding og eiendomsinformasjon for norske adresser.

GET/v1/adresser
POST/v1/adresser/valider
GET/v1/geokoding

Webhooks

Administrer abonnementer på hendelser og se leveringslogg.

POST/v1/webhooks
GET/v1/webhooks/{id}/leveranser
POST/v1/webhooks/{id}/leveranser/{hendelse_id}/send

OpenAPI

Hele API-et er beskrevet i en OpenAPI 3.1-spesifikasjon som SDK-ene og denne referansen genereres fra. Den ligger på https://api.spireapi.com/openapi.json og kan brukes til å generere egne klienter.

Fant du en feil? Si fra, så retter vi innen en virkedag.