Signeringer

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

POST/v1/signeringerOpprett signeringsjobb
GET/v1/signeringer/{id}Hent status
GET/v1/signeringer/{id}/dokumentLast ned signert PDF
DELETE/v1/signeringer/{id}Avbryt jobb

POST/v1/signeringer

Opprett signeringsjobb

Oppretter en jobb med ett dokument og én eller flere parter. Dokumentet kan sendes som multipart (PDF) eller hentes fra «dokument_url».

Kropp (JSON)

tittelstringpåkrevd
Vises for partene og i e-post.
dokument_urlstring
HTTPS-URL til PDF, maks 25 MB. Alternativt feltet «dokument» i multipart.
nivaastringpåkrevd
«enkel», «eid» eller «kvalifisert».
parterobject[]påkrevd
Hver part: «navn», «epost», valgfritt «mobil», «rolle», «rekkefolge» (heltall) og «fodselsnummer_hash» for å låse til identitet.
fristdate
Standard 30 dager.
paaminnelserinteger[]
Dager etter opprettelse. Standard [1, 3, 7].
innebygdboolean
true gir lenker for iframe i stedet for e-post til partene.
lagring_dagerinteger
0–3650. Standard 30.

forespørsel

curl -X POST https://api.spireapi.com/v1/signeringer \
  -H "Authorization: Bearer sk_test_…" -F tittel="Leieavtale" -F nivaa=eid -F [email protected] \
  -F 'parter=[{"navn":"Ingrid Åsheim","epost":"[email protected]"}]'

svar

{
  "id": "sig_01JBX5K0T9PQ",
  "status": "venter",
  "nivaa": "eid",
  "parter": [
    { "id": "prt_1", "navn": "Ingrid Åsheim", "status": "venter", "lenke": "https://signer.spireapi.com/s/8f3k2…" }
  ],
  "frist": "2026-11-17T23:59:59+01:00"
}

GET/v1/signeringer/{id}

Hent status

Jobben med status per part, tidspunkter og eventuelt identitetsbevis.

Stiparametre

idstringpåkrevd
Signerings-ID.

forespørsel

curl https://api.spireapi.com/v1/signeringer/sig_01JBX5K0T9PQ \
  -H "Authorization: Bearer sk_test_…"

svar

{
  "id": "sig_01JBX5K0T9PQ",
  "status": "fullfort",
  "parter": [
    { "id": "prt_1", "navn": "Ingrid Åsheim", "status": "signert", "signert": "2026-11-04T08:12:30Z", "identitet": { "verifisert_navn": "Ingrid Åsheim", "fodselsdato": "1979-05-14", "metode": "eid" } }
  ],
  "dokument_url": "https://api.spireapi.com/v1/signeringer/sig_01JBX5K0T9PQ/dokument"
}

GET/v1/signeringer/{id}/dokument

Last ned signert PDF

PDF med innebygde signaturer (PAdES-LTV). Tilgjengelig i «lagring_dager» etter fullføring.

Stiparametre

idstringpåkrevd
Signerings-ID.

forespørsel

curl -o signert.pdf https://api.spireapi.com/v1/signeringer/sig_01JBX5K0T9PQ/dokument \
  -H "Authorization: Bearer sk_test_…"

svar

HTTP/2 200
Content-Type: application/pdf
Content-Disposition: attachment; filename="leieavtale-signert.pdf"

DELETE/v1/signeringer/{id}

Avbryt jobb

Avbryter en jobb som ikke er fullført. Partene varsles. Ingen kostnad.

Stiparametre

idstringpåkrevd
Signerings-ID.

forespørsel

curl -X DELETE https://api.spireapi.com/v1/signeringer/sig_01JBX5K0T9PQ \
  -H "Authorization: Bearer sk_test_…"

svar

{ "id": "sig_01JBX5K0T9PQ", "status": "avbrutt" }

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