List fakturaer

GET/api/v1/invoices

Virker

Sendte fakturaer, kreditnotaer og «Fakturert i regnskapet», nyeste først. Utkast kommer bare med includeDrafts=true. Filtrer på status, customerId, issuedSince (fakturadato, Oslo) og updatedSince. En kundenøkkel ser bare sin egen kundes sendte fakturaer, aldri et utkast.

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

Parametre

I spørringen

statusstring
Verdierutkastsendtforfaltbetaltkansellertkreditert
customerIdstring · uuid
UUID
issuedSincestring · dateeks. 2026-12-18
Dato på Oslo-kalenderen, ÅÅÅÅ-MM-DD
updatedSincestring · date-timeeks. 2026-12-14T09:03:00.000Z
Tidspunkt, ISO 8601 i UTC
includeDraftsstring
Verdiertruefalse
limitinteger1–100
Antall per side, 1–100 (25 når den mangler).
cursorstringhøyst 400 tegn
nextCursor fra forrige side.

Svaret

200OKFakturaene

application/jsonInvoiceList

dataInvoice[]Må med
Vis 20 feltSkjul 20 felt
- idstring · uuidMå med
  UUID
- kindstringMå med
  Verdierinvoicecredit_noteerp_mark
- numberstringMå medkan være null
- statusstringMå med
  Verdierutkastsendtforfaltbetaltkansellertkreditert
- issueDatestring · dateMå medkan være nulleks. 2026-12-18
  Dato på Oslo-kalenderen, ÅÅÅÅ-MM-DD
- dueDatestring · dateMå medkan være nulleks. 2026-12-18
  Dato på Oslo-kalenderen, ÅÅÅÅ-MM-DD
- kidstringMå medkan være null
- customerobjectMå medkan være null
  Vis 3 feltSkjul 3 felt
  - idstring · uuidMå med
    UUID
  - numberintegerMå medkan være null
  - namestringMå med
- orderReferencestringMå medkan være null
- customerReferencestringMå medkan være null
- orderNumbersinteger[]Må med
- currencystringMå med
  Alltid "NOK"
- netOreintegerMå medkan være null
  Hele øre (1 kr = 100 øre)
- vatOreintegerMå medkan være null
  Hele øre (1 kr = 100 øre)
- grossOreintegerMå medkan være null
  Hele øre (1 kr = 100 øre)
- linesInvoiceLine[]Må med
  Vis 6 feltSkjul 6 felt
  - descriptionstringMå med
    Varen slik den står på fakturaen: navnet og målene.
  - quantitynumberMå med
  - unitstringMå medkan være null
    Alltid null i v1: fakturalinjene lagrer ingen enhet. Enheten står i description når den er kjent.
  - unitPriceOreintegerMå med
    Hele øre (1 kr = 100 øre)
  - netOreintegerMå med
    Hele øre (1 kr = 100 øre)
  - vatBpintegerMå med0–10000
    Moms i basispunkter: 2500 = 25 %
- erpobjectMå medkan være null
  Vis 2 feltSkjul 2 felt
  - vendorstringMå med
    Verdierpowerofficetripletexfiken
  - invoiceNostringMå medkan være null
- paidAtstring · date-timeMå medkan være nulleks. 2026-12-14T09:03:00.000Z
  Tidspunkt, ISO 8601 i UTC
- createdAtstring · date-timeMå medeks. 2026-12-14T09:03:00.000Z
  Tidspunkt, ISO 8601 i UTC
- updatedAtstring · date-timeMå medeks. 2026-12-14T09:03:00.000Z
  Tidspunkt, ISO 8601 i UTC
nextCursorstringMå medkan være null

Feilkoder

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

400Bad Request

invalid_cursorMarkøren (cursor) er ikke en vi har gitt ut.
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.

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/invoices

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

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

$ch = curl_init('https://vbeslag.com/api/v1/invoices');
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": [
    {
      "id": "78dc0317-6985-41e7-aeb9-9deed0da1e24",
      "kind": "invoice",
      "number": "tekst",
      "status": "utkast",
      "issueDate": "2026-12-18",
      "dueDate": "2026-12-18",
      "kid": "0104424",
      "customer": {
        "id": "87febf70-b0ae-4c70-a5cd-01339c01bce3",
        "number": 312,
        "name": "Byggmester Hansen AS"
      },
      "orderReference": "tekst",
      "customerReference": "tekst",
      "orderNumbers": [
        4711
      ],
      "currency": "NOK",
      "netOre": 61200,
      "vatOre": 61200,
      "grossOre": 61200,
      "lines": [
        {
          "description": "Vindskie 150×40, stål sort",
          "quantity": 1.5,
          "unit": "stk",
          "unitPriceOre": 61200,
          "netOre": 61200,
          "vatBp": 2500
        }
      ],
      "erp": {
        "vendor": "poweroffice",
        "invoiceNo": "tekst"
      },
      "paidAt": "2026-12-14T09:03:00.000Z",
      "createdAt": "2026-12-14T09:03:00.000Z",
      "updatedAt": "2026-12-14T09:03:00.000Z"
    }
  ],
  "nextCursor": "tekst"
}