Gå til innholdet

Opprette prosjekter

Du kan opprette prosjekter fra ditt eget system, for eksempel når en arbeidsordre eller en befaring opprettes der, slik at arbeidet kan starte i Wenn Property før noen har vært på stedet.

Et prosjekt plasseres med adresse-ID-en: ID-en til en registrert vegadresse, som du bygger fra nøklene ethvert adressesøk mot Kartverket returnerer. Fritekstadresser godtas ikke, og vi tilbyr ikke adressesøk.

Begge endepunktene krever scope write:projects. Det er separat fra read:projects. Svaret inneholder prosjektet du opprettet eller endret, så write:projects alene er nok til å lese disse prosjektene fra disse endepunktene.

Authorization: Bearer <ditt-token>
POST /v1/projects

Request body (valgfri):

FeltTypeBeskrivelse
addressIdstringValgfri. Adresse-ID-en til en registrert vegadresse. Uten den opprettes prosjektet uten adresse
unitNumberstringValgfri. Leilighetens bruksenhetsnummer, f.eks. H0203. Bare sammen med addressId

Eksempel:

POST /v1/projects
Content-Type: application/json
{
"addressId": "0301146220004000A000",
"unitNumber": "H0203"
}

Returnerer 201 Created med prosjektet i samme form som GET /v1/projects/{projectId}. Adressen slås opp hos oss, så street, postalCode og city er fylt ut (se Adresse for feltene):

{
"id": "6720f0c2a1b2c3d4e5f60718",
"createdAt": "2026-10-29T09:12:44Z",
"createdBy": "gripr",
"lastUpdated": "2026-10-29T09:12:44Z",
"type": null,
"address": {
"street": "Maridalsveien 4A",
"postalCode": "0178",
"city": "OSLO",
"unitNumber": "H0203"
},
"coverPhoto": null,
"photos": [],
"rooms": [],
"outsideAreas": [],
"aiSummary": null,
"inspectionNotes": null,
"archived": false
}

Hvis adresse-ID-en ikke gir treff på en registrert vegadresse, feiler forespørselen med 422 address_not_found, og ingen prosjekter opprettes. Feilen inneholder ingen forslag.

Flere prosjekter kan ha samme adresse. Det er vanlig, for eksempel egne prosjekter for bad, fasade og garasje, så det er ikke en feil å opprette et prosjekt på en adresse som allerede har et.

createdBy er brukerens ID når en bruker oppretter prosjektet, og API-klientens navn (slik det ble oppgitt da klienten ble opprettet) når en backend-integrasjon oppretter det. Det lagres med små bokstaver, så en klient som heter Gripr, vises som gripr. Et navn med tegn utenfor Latin-1 (som –) brukes ikke; da lagres tokenets sub i stedet, som for en backend-integrasjon er <client_id>@clients, også med små bokstaver.

PUT /v1/projects/{projectId}/address

Setter adressen på et prosjekt, for eksempel ett som ble opprettet uten adresse, eller erstatter adressen det har. Tak- og veggdata utledes fra adressen, så når adressen erstattes, erstattes de også.

Request body:

FeltTypeBeskrivelse
addressIdstringPåkrevd. Adresse-ID-en til en registrert vegadresse
unitNumberstring | nullValgfri. Leilighetens bruksenhetsnummer, f.eks. H0203, som lagres sammen med adressen i samme endring. null fjerner det. Utelatt beholder prosjektet bruksenhetsnummeret når samme adresse settes på nytt, og mister det når adressen er en annen

Eksempel:

PUT /v1/projects/6720f0c2a1b2c3d4e5f60718/address
Content-Type: application/json
{
"addressId": "11030365500010000000"
}

Returnerer 200 OK med det oppdaterte prosjektet, i samme form som GET /v1/projects/{projectId}. Hvis adresse-ID-en ikke gir treff, feiler forespørselen med 422 address_not_found, og prosjektet er uendret.

Bruksenhetsnummeret er leilighetens nummer i det offisielle registeret, for eksempel H0203, og lar deg skille prosjekter på samme adresse fra hverandre. Det er én bokstav og fire sifre:

DelBetydning
BokstavEtasjetype: H hovedetasje, K kjeller, U underetasje, L loft
De to første sifreneEtasjen
De to siste sifreneEnheten i etasjen

Små bokstaver godtas og lagres som store. Bare formatet kontrolleres, ikke om adressen har det bruksenhetsnummeret registrert. Eneboliger har som regel ikke bruksenhetsnummer; utelat da feltet.

Adresse-ID-en er 20 tegn, bygget fra fem deler av en vegadresse i det offisielle adresseregisteret:

DelLengdeRegel
kommunenummer4Som det er, f.eks. 0301
adressekode5Fylt ut med nuller foran
nummer (husnummer)4Fylt ut med nuller foran
bokstav (husbokstav)4Den store bokstaven fylt ut med nuller foran (000A), eller 0000 når det ikke er bokstav
undernummer3Alltid 000 for vegadresser

Ethvert adressesøk mot Kartverkets åpne adresse-API returnerer nøklene du trenger. For eksempel:

GET https://ws.geonorge.no/adresser/v1/sok?sok=Maridalsveien%204A&kommunenummer=0301

Hvert treff i adresser har kommunenummer, adressekode, nummer og bokstav (tom streng når det ikke er bokstav). Integrasjoner som allerede bruker et adressesøk bygget på det offisielle adresseregisteret, har som regel de samme nøklene.

function addressId(address: {
kommunenummer: string;
adressekode: number;
nummer: number;
bokstav: string;
}): string {
return (
address.kommunenummer +
String(address.adressekode).padStart(5, "0") +
String(address.nummer).padStart(4, "0") +
address.bokstav.toUpperCase().padStart(4, "0") +
"000"
);
}
AdressekommunenummeradressekodenummerbokstavAdresse-ID
Krysantemumhagen 1, Stavanger110336551–11030365500010000000
Maridalsveien 4A, Oslo (bygning med seks enheter)0301146224A0301146220004000A000
Gamle Maridalsvei 100, Oslo030112167100–03011216701000000000

Alle enhetene i en bygning deler adresse-ID-en til bygningens adresse.

Bare registrerte vegadresser støttes. Matrikkeladresser — eiendommer med bare gårdsnummer og bruksnummer og ingen gate — støttes ikke. ID-ene deres kan ha samme form som en vegadresse-ID, så de avvises av oppslaget med 422 address_not_found, ikke av formkontrollen.

StatusKodeNår
400invalid_requestBody er ugyldig: en feilformet adresse-ID (feil lengde, en bokstav utenfor husbokstavplassen, liten bokstav), et feilformet bruksenhetsnummer, unitNumber uten addressId på POST, manglende addressId på PUT, eller et felt endepunktet ikke tar imot
403forbiddenTokenet mangler write:projects-scope
404project_not_foundProsjektet finnes ikke (bare PUT)
409address_conflictNoen andre endret prosjektets adresse mens den ble satt (bare PUT). Prøv forespørselen på nytt
422address_not_foundAdresse-ID-en er ikke en registrert vegadresse. Ingen prosjekter opprettes, og et eksisterende prosjekt er uendret