Hent en kunde

GET/api/v1/customers/{id}

Virker

Med kontakt, adresser og innstillingene ordrene leser (SMS, prosjektnr, faste dager).

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

Parametre

I adressen

idstring · uuidMå med
UUID

Svaret

200OKKunden

application/jsonCustomer

Vis alle 20 feltSkjul de 20 feltene

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

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.
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.

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/customers/{id}

curl https://vbeslag.com/api/v1/customers/5d0a7c3e-2f41-4b9a-8e6d-1a2b3c4d5e6f \
  -H "Authorization: Bearer vb_test_…"

const res = await fetch('https://vbeslag.com/api/v1/customers/5d0a7c3e-2f41-4b9a-8e6d-1a2b3c4d5e6f', {
  headers: {
    Authorization: 'Bearer vb_test_…',
  },
})
const data = await res.json()

$ch = curl_init('https://vbeslag.com/api/v1/customers/5d0a7c3e-2f41-4b9a-8e6d-1a2b3c4d5e6f');
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

{
  "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"
}