List kunder

GET/api/v1/customers

Virker

Etter kundenummer, eller etter endring for å synkronisere. Søk med q.

Rettigheter: customers:read
Kundenøkkel: Nei
Grense: lesing, 120 i minuttet
Siden: 5. oktober 2026

Parametre

I spørringen

qstringhøyst 100 tegn
Søk i navn, org.nr. eller telefon.
updatedSincestring · date-timeeks. 2026-12-14T09:03:00.000Z
Tidspunkt, ISO 8601 i UTC
includeArchivedboolean
sortstring
Etter kundenummer (number, standard) eller etter endring (updatedAt).
VerdiernumberupdatedAt
limitinteger1–100
Antall per side, 1–100 (25 når den mangler).
cursorstringhøyst 400 tegn
nextCursor fra forrige side.

Svaret

200OKEn side med kunder

application/jsonCustomerList

dataCustomer[]Må med
Vis 20 feltSkjul 20 felt
- idstring · uuidMå med
  UUID
- numberintegerMå medkan være null
  Kundenummeret i registeret (1, 2, 3 …).
- kindstringMå med
  Verdierfirmaprivat
- namestringMå med
- orgNrstringMå medkan være null
- contactPersonstringMå medkan være null
- emailstringMå medkan være null
- mobilestringMå medkan være null
  Nummeret Klar-SMS går til, +47…
- phonestringMå medkan være null
- invoiceAddressobjectMå medkan være null
  Vis 4 feltSkjul 4 felt
  - linestringMå medkan være null
  - postalCodestringMå medkan være null
  - citystringMå medkan være null
  - countrystringMå medkan være null
- deliveryAddressobjectMå medkan være null
  Vis 4 feltSkjul 4 felt
  - linestringMå medkan være null
  - postalCodestringMå medkan være null
  - citystringMå medkan være null
  - countrystringMå medkan være null
- invoicingModestringMå med
  Verdierper_ordreper_prosjektprosjekt_mnd
- requiresProjectNobooleanMå med
  «Krever prosjektnr»: en ordre uten prosjektnummer blir avvist.
- requiresOrdererbooleanMå med
  «Krever bestiller».
- smsOnReadybooleanMå med
- deliveryWeekdaysinteger[]Må medkan være null
  Faste leveringsdager, 1 = mandag … 7 = søndag.
- erpRefsobject[]Må med
  Kunden i regnskapet. Da eier regnskapet navn og org.nr.
  Vis 2 feltSkjul 2 felt
  - vendorstringMå med
    Verdierpowerofficetripletexfiken
  - externalNostringMå med
- archivedbooleanMå med
- 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
Gi denne som cursor for neste side; null når det ikke er flere.

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.
customer_key_not_allowedEn kundenøkkel kan ikke gjøre dette.
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/customers

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

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

$ch = curl_init('https://vbeslag.com/api/v1/customers');
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": "87febf70-b0ae-4c70-a5cd-01339c01bce3",
      "number": 312,
      "kind": "firma",
      "name": "Byggmester Hansen AS",
      "orgNr": "914276640",
      "contactPerson": "Kari Nordmann",
      "email": "kari@example.no",
      "mobile": "+4791234567",
      "phone": "+4791234567",
      "invoiceAddress": {
        "line": "Industriveien 4",
        "postalCode": "9405",
        "city": "Harstad",
        "country": "NO"
      },
      "deliveryAddress": {
        "line": "Industriveien 4",
        "postalCode": "9405",
        "city": "Harstad",
        "country": "NO"
      },
      "invoicingMode": "per_ordre",
      "requiresProjectNo": false,
      "requiresOrderer": false,
      "smsOnReady": false,
      "deliveryWeekdays": [
        1
      ],
      "erpRefs": [
        {
          "vendor": "poweroffice",
          "externalNo": "tekst"
        }
      ],
      "archived": false,
      "createdAt": "2026-12-14T09:03:00.000Z",
      "updatedAt": "2026-12-14T09:03:00.000Z"
    }
  ],
  "nextCursor": "tekst"
}