Ordrens tidslinje

GET/api/v1/orders/{number}/events

Virker

Hvert steg med fra- og til-status, hvem (som type, aldri navn) og når.

Rettigheter: orders:read
Kundenøkkel: Ja, for sine egne
Grense: lesing, 120 i minuttet
Siden: 5. oktober 2026

Parametre

I adressen

numberstringMå medhøyst 12 tegn
«4711», «004711», «T-000012» (testnøkler), eller et lappnummer som er blitt ordrens.

Svaret

200OKTidslinjen

application/jsonOrderEventList

dataOrderEvent[]Må med
Vis 5 feltSkjul 5 felt
- typestringMå med
- fromStatusstringMå medkan være null
  Lagret status: forespurt, mottatt, i_arbeid, klar, levert, fakturert, betalt, avbrutt. Stigen får aldri et nytt trinn uten v2.
  Verdierforespurtmottatti_arbeidklarlevertfakturertbetaltavbrutt
- toStatusstringMå medkan være null
  Lagret status: forespurt, mottatt, i_arbeid, klar, levert, fakturert, betalt, avbrutt. Stigen får aldri et nytt trinn uten v2.
  Verdierforespurtmottatti_arbeidklarlevertfakturertbetaltavbrutt
- actorKindstringMå med
  Hvem: aldri et navn.
  Verdieruserpersondevicecustomerapi_keysystem
- occurredAtstring · date-timeMå medeks. 2026-12-14T09:03:00.000Z
  Tidspunkt, ISO 8601 i UTC

Feilkoder

Alle feil har samme form. Velg handling etter code, aldri etter message. Les mer under Feil.

400Bad Request

invalid_requestNoe i forespørselen er feil eller ukjent. fields sier hva.

401Unauthorized

unauthorizedNøkkelen mangler, er feil, er slått av eller har gått ut. En nøkkel som slås av, slutter å virke innen 1 minutt.

403Forbidden

account_closedVerkstedet er stengt.
dpa_requiredVerkstedet må godta databehandleravtalen før koblinger kan brukes.
feature_not_in_planVerkstedet har ikke slått på delen dette trenger. feature sier hvilken.
insufficient_scopeNøkkelen har ikke lov til dette. requiredScope sier hvilken rett som mangler.

404Not Found

not_foundFant ikke dette.

429Too Many Requests

rate_limitedFor mange kall. Vent retryAfterSeconds sekunder.

500Internal Server Error

internalNoe gikk galt hos oss. Feilen er meldt. Oppgi requestId hvis du spør.

GET/orders/{number}/events

curl https://vbeslag.com/api/v1/orders/004711/events \
  -H "Authorization: Bearer vb_test_…"

const res = await fetch('https://vbeslag.com/api/v1/orders/004711/events', {
  headers: {
    Authorization: 'Bearer vb_test_…',
  },
})
const data = await res.json()

$ch = curl_init('https://vbeslag.com/api/v1/orders/004711/events');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer vb_test_…',
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Svaret

HTTP/1.1 200 OK
Content-Type: application/json

{
  "data": [
    {
      "type": "tekst",
      "fromStatus": "forespurt",
      "toStatus": "forespurt",
      "actorKind": "user",
      "occurredAt": "2026-12-14T09:03:00.000Z"
    }
  ]
}