Mapper

Metode	Sti	Beskrivelse
GET	/external/portfolios/	List rotmapper
GET	/external/portfolios/{id}/	Hent en mappe med undermappene og eiendommene som ligger direkte i den

I API-et heter mapper portfolios, derav endepunktene og feltnavn som portfolio_id. Mapper kan ikke opprettes eller endres via API-et. Administrer dem i Telescope-appen.

List rotmapper

GET /external/portfolios/

Returnerer bare det øverste nivået i mappetreet, paginert på samme måte som eiendomslisten.

{
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "b2a4c7e0-1d2f-4f39-8e2a-5c6d7e8f9a01",
      "name": "Norway",
      "internal_reference_id": "",
      "updated_at": "2026-08-12T07:30:00.000000Z"
    }
  ]
}

Felt	Type	Beskrivelse
id	UUID	Telescopes identifikator for mappen. Bruk den som portfolio_id når du oppretter eiendommer.
name	tekst	Navnet på mappen.
internal_reference_id	tekst	Egen referanse for mappen. Tom streng når den ikke er satt.
updated_at	tidspunkt	Når mappen sist ble endret.

Hent en mappe

GET /external/portfolios/{id}/

Returnerer mappen med den overordnede mappen og alt som ligger direkte i den. For å gå gjennom hele treet henter du hver undermappe etter tur.

{
  "id": "e5f6a7b8-0c1d-4e2f-9a3b-4c5d6e7f8a90",
  "name": "Oslo",
  "internal_reference_id": "REG-OSL",
  "parent_id": "b2a4c7e0-1d2f-4f39-8e2a-5c6d7e8f9a01",
  "updated_at": "2026-08-12T07:31:00.000000Z",
  "portfolios": [
    {
      "id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "name": "Office",
      "internal_reference_id": "",
      "updated_at": "2026-08-12T07:32:00.000000Z"
    }
  ],
  "properties": [
    {
      "id": "3f6c1a52-8a1e-4c3e-9a57-0b1f6f0c2d11",
      "internal_reference_id": "P-1001",
      "name": "Storgata 1",
      "value_estimate": 85000000,
      "portfolio_id": "e5f6a7b8-0c1d-4e2f-9a3b-4c5d6e7f8a90",
      "address": "Storgata 1",
      "postal_code": "0155",
      "postal_area": "Oslo",
      "matrikkelnummer": "0301-208/101/0/0",
      "created_at": "2026-03-02T09:14:07.512345Z",
      "updated_at": "2026-09-30T12:01:44.104221Z"
    }
  ]
}

Felt	Type	Beskrivelse
id, name, internal_reference_id, updated_at		Som i listen.
parent_id	UUID eller null	Den overordnede mappen, eller null for en rotmappe.
portfolios	liste	Undermapper som ligger direkte i denne mappen, sortert etter navn, med de samme feltene som i listen.
properties	liste	Eiendommer som ligger direkte i denne mappen, sortert etter navn.

Eiendommene her er en kortversjon, uten country og uten resultater. Bruk GET /external/properties/{id}/ for hele eiendommen, eller list eiendommer og grupper dem etter portfolio_id.

Ingen av listene er paginert. Eiendommer i undermapper er ikke med.