{
  "openapi": "3.0.1",
  "info": {
    "title": "API for saksbehandlingsdata",
    "description": "API'er for saksbehandlingsdata skal fange opp formell kommunikasjon fra saksbehandler i kommunen til søker.",
    "version": "1.0"
  },
  "paths": {
    "/api/v1/Dokument": {
      "post": {
        "tags": [
          "Dokument"
        ],
        "summary": "Leverandører av sak-/arkivsystem bruker dette API'et til å last opp dokument som skal tilgjengeliggjøres for søknadssystemene.\r\nSwagger-dokumentasjonen ser ikke helt korrekt ut, men dette skal utbedres...",
        "parameters": [
          {
            "name": "dokumentMetadata",
            "in": "query",
            "description": "Metadata til dokument som skal lastes opp",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/DokumentMetadataApiModel"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "ContentType": {
                    "type": "string"
                  },
                  "ContentDisposition": {
                    "type": "string"
                  },
                  "Headers": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "Length": {
                    "type": "integer",
                    "format": "int64"
                  },
                  "Name": {
                    "type": "string"
                  },
                  "FileName": {
                    "type": "string"
                  }
                }
              },
              "encoding": {
                "ContentType": {
                  "style": "form"
                },
                "ContentDisposition": {
                  "style": "form"
                },
                "Headers": {
                  "style": "form"
                },
                "Length": {
                  "style": "form"
                },
                "Name": {
                  "style": "form"
                },
                "FileName": {
                  "style": "form"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success"
          }
        }
      }
    },
    "/api/v1/Dokument/{dokumentId}": {
      "get": {
        "tags": [
          "Dokument"
        ],
        "summary": "Leverandører av søknadssystem bruker dette API'et for å hente ned dokumenter.",
        "parameters": [
          {
            "name": "dokumentId",
            "in": "path",
            "description": "Id på dokumentet. Blir levert til søknadssystemet via vedtak og mangler.",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Ok - dokumentet returneres"
          },
          "404": {
            "description": "Kan ikke finne dokument med angitt dokumentId",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "410": {
            "description": "Dokumentet er slettet og kan ikke tilgjengeliggjøres",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/Kvittering": {
      "post": {
        "tags": [
          "Kvittering"
        ],
        "summary": "Brukes til å gi kvittering om at en sending er mottatt og tildelt saksnummer i kommunen. API-et inneholder informasjon søker trenger for å vite at innsendingen er registrert.",
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/KvitteringApiModel"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/KvitteringApiModel"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/KvitteringApiModel"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Kvittering er mottatt",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/SaksbehandlingsdataApiCreatedResponseModel"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SaksbehandlingsdataApiCreatedResponseModel"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/SaksbehandlingsdataApiCreatedResponseModel"
                }
              }
            }
          },
          "400": {
            "description": "Requesten har feil i data",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "409": {
            "description": "Kvittering er allerede registrert for InnsendingsReferansen",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/MetadataApiModel"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MetadataApiModel"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/MetadataApiModel"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Kvittering"
        ],
        "summary": "Leverer kvittering for mottatt innsending",
        "parameters": [
          {
            "name": "innsendingReferanse",
            "in": "query",
            "description": "Referanse til innsendingen, feks AR-koden fra Altinn",
            "schema": {
              "type": "string"
            },
            "example": "AR123456"
          }
        ],
        "responses": {
          "200": {
            "description": "Kvitteringen returneres",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/KvitteringApiModel"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KvitteringApiModel"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/KvitteringApiModel"
                }
              }
            }
          },
          "404": {
            "description": "Klarer ikke finne kvittering for angitte verdier",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/Mangel": {
      "post": {
        "tags": [
          "Mangel"
        ],
        "summary": "Brukes til å informere søker om søknadens mangler, og saksbehandlers behov for at søknaden blir supplert.\r\nAPI for mangler utløses når sjekklisteutfallene krever behov for mer informasjon, og saksbehandler kvitterer ut milepælen “Mangelbrev” (MB).",
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MangelApiModel"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/MangelApiModel"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/MangelApiModel"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Mangel er mottatt",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/SaksbehandlingsdataApiCreatedResponseModel"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SaksbehandlingsdataApiCreatedResponseModel"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/SaksbehandlingsdataApiCreatedResponseModel"
                }
              }
            }
          },
          "400": {
            "description": "Requesten har feil i data",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Mangel"
        ],
        "summary": "Leverer mangel for mottatt innsending",
        "parameters": [
          {
            "name": "Id",
            "in": "query",
            "description": "Saksbehandlingsdata Id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "example": "a3555d83-6c49-4efd-b74a-a8b5497c0b76"
            },
            "example": "a3555d83-6c49-4efd-b74a-a8b5497c0b76"
          },
          {
            "name": "InnsendingReferanse",
            "in": "query",
            "description": "Referansen for innsendingen. Dette vil typisk være altinnreferansen.",
            "schema": {
              "type": "string",
              "example": "AR123456789"
            },
            "example": "AR123456789"
          }
        ],
        "responses": {
          "200": {
            "description": "Mangel returneres",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/MangelApiModel"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/MangelApiModel"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/MangelApiModel"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Klarer ikke finne mangel for angitte verdier",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/Milepel": {
      "post": {
        "tags": [
          "Milepel"
        ],
        "summary": "Brukes til å informere søker når saksbehandlingen har ført til en endring av milepælene.\r\nAPI for oppdatert milepæl utløses når saksbehandler endrer en milepæl, for eksempel når søknaden er komplett eller når søknaden må sendes til vurdering av en annen myndighet.",
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MilepelApiModel"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/MilepelApiModel"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/MilepelApiModel"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Milepæl er mottatt",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/SaksbehandlingsdataApiCreatedResponseModel"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SaksbehandlingsdataApiCreatedResponseModel"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/SaksbehandlingsdataApiCreatedResponseModel"
                }
              }
            }
          },
          "400": {
            "description": "Requesten har feil i data",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Milepel"
        ],
        "summary": "Leverer milepæl for mottatt innsending",
        "parameters": [
          {
            "name": "Id",
            "in": "query",
            "description": "Saksbehandlingsdata Id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "example": "a3555d83-6c49-4efd-b74a-a8b5497c0b76"
            },
            "example": "a3555d83-6c49-4efd-b74a-a8b5497c0b76"
          },
          {
            "name": "InnsendingReferanse",
            "in": "query",
            "description": "Referansen for innsendingen. Dette vil typisk være altinnreferansen.",
            "schema": {
              "type": "string",
              "example": "AR123456789"
            },
            "example": "AR123456789"
          }
        ],
        "responses": {
          "200": {
            "description": "Milepæl hentet",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/MilepelApiModel"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MilepelApiModel"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/MilepelApiModel"
                }
              }
            }
          },
          "404": {
            "description": "Fant ingen milepæl på angitt innsendingsreferanse eller id",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/SaksnummerEndringer": {
      "post": {
        "tags": [
          "SaksnummerEndringer"
        ],
        "summary": "Brukes til å gi informasjon om endring av saksnummer.",
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SaksnummerEndringApiModel"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/SaksnummerEndringApiModel"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/SaksnummerEndringApiModel"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "SaksnummerEndring er mottatt",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/SaksbehandlingsdataApiCreatedResponseModel"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SaksbehandlingsdataApiCreatedResponseModel"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/SaksbehandlingsdataApiCreatedResponseModel"
                }
              }
            }
          },
          "400": {
            "description": "Requesten har feil i data",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "SaksnummerEndringer"
        ],
        "summary": "Leverer informasjon om endring av saksnummer",
        "parameters": [
          {
            "name": "Id",
            "in": "query",
            "description": "Saksbehandlingsdata Id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "example": "a3555d83-6c49-4efd-b74a-a8b5497c0b76"
            },
            "example": "a3555d83-6c49-4efd-b74a-a8b5497c0b76"
          },
          {
            "name": "InnsendingReferanse",
            "in": "query",
            "description": "Referansen for innsendingen. Dette vil typisk være altinnreferansen.",
            "schema": {
              "type": "string",
              "example": "AR123456789"
            },
            "example": "AR123456789"
          }
        ],
        "responses": {
          "200": {
            "description": "Informasjon om endirnger av saksnummer returneres",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SaksnummerEndringApiModel"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SaksnummerEndringApiModel"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SaksnummerEndringApiModel"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Klarer ikke finne infomrasjon om endring av saksnummer for angitte verdier",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/Saksoppdatering": {
      "post": {
        "tags": [
          "Saksoppdatering"
        ],
        "summary": "Brukes for å gi søker og søknadsløsningen informasjon om at søknadstypen eller tiltakstypen(e) er endret.\r\nDette API-et har ingen kobling til milepæl eller utfall.",
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SaksoppdateringApiModel"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/SaksoppdateringApiModel"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/SaksoppdateringApiModel"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Saksoppdatering er mottatt",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/SaksbehandlingsdataApiCreatedResponseModel"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SaksbehandlingsdataApiCreatedResponseModel"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/SaksbehandlingsdataApiCreatedResponseModel"
                }
              }
            }
          },
          "400": {
            "description": "Requesten har feil i data",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Saksoppdatering"
        ],
        "summary": "Leverer saksoppdatering for mottatt innsending",
        "parameters": [
          {
            "name": "Id",
            "in": "query",
            "description": "Saksbehandlingsdata Id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "example": "a3555d83-6c49-4efd-b74a-a8b5497c0b76"
            },
            "example": "a3555d83-6c49-4efd-b74a-a8b5497c0b76"
          },
          {
            "name": "InnsendingReferanse",
            "in": "query",
            "description": "Referansen for innsendingen. Dette vil typisk være altinnreferansen.",
            "schema": {
              "type": "string",
              "example": "AR123456789"
            },
            "example": "AR123456789"
          }
        ],
        "responses": {
          "200": {
            "description": "Saksoppdatering hentet",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/SaksoppdateringApiModel"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SaksoppdateringApiModel"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/SaksoppdateringApiModel"
                }
              }
            }
          },
          "404": {
            "description": "Fant ingen saksoppdatering på angitt innsendingsreferanse eller id",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/Vedtak": {
      "post": {
        "tags": [
          "Vedtak"
        ],
        "summary": "Brukes til å informere søker når vedtak er fattet, og hvilke vilkår som er satt.\r\nAPI for vedtak utløses når vedtak er fattet og hvis sjekklisteutfallene krever vilkår eller oppfølgingspunkt i neste fase.",
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VedtakApiModel"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/VedtakApiModel"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/VedtakApiModel"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Vedtak er mottatt",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/SaksbehandlingsdataApiCreatedResponseModel"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SaksbehandlingsdataApiCreatedResponseModel"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/SaksbehandlingsdataApiCreatedResponseModel"
                }
              }
            }
          },
          "400": {
            "description": "Requesten har feil i data",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Vedtak"
        ],
        "summary": "Leverer vedtak for mottatt innsending",
        "parameters": [
          {
            "name": "Id",
            "in": "query",
            "description": "Saksbehandlingsdata Id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "example": "a3555d83-6c49-4efd-b74a-a8b5497c0b76"
            },
            "example": "a3555d83-6c49-4efd-b74a-a8b5497c0b76"
          },
          {
            "name": "InnsendingReferanse",
            "in": "query",
            "description": "Referansen for innsendingen. Dette vil typisk være altinnreferansen.",
            "schema": {
              "type": "string",
              "example": "AR123456789"
            },
            "example": "AR123456789"
          }
        ],
        "responses": {
          "200": {
            "description": "Vedtak returneres",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/VedtakApiModel"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VedtakApiModel"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/VedtakApiModel"
                }
              }
            }
          },
          "404": {
            "description": "Klarer ikke finne vedtak for angitte verdier",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "AvsenderKontaktpunktApiModel": {
        "type": "object",
        "properties": {
          "navn": {
            "type": "string",
            "description": "Navn på saksbehandler eller avdeling som er ansvarlig",
            "nullable": true,
            "example": "Byggesaksavdelingen"
          },
          "epost": {
            "type": "string",
            "format": "email",
            "nullable": true
          },
          "telefon": {
            "type": "string",
            "description": "Telefonnummer til kontaktpunkt",
            "nullable": true,
            "example": "35950000"
          },
          "mobil": {
            "type": "string",
            "description": "Mobilnummer til kontaktpunkt",
            "nullable": true,
            "example": "99887744"
          }
        },
        "additionalProperties": false,
        "description": "Navn og kontaktinformasjon til saksbehandler eller avdeling som er ansvarlig for å behandle søknaden."
      },
      "BeskrivelseAvUtfallApiModel": {
        "required": [
          "beskrivelse",
          "tittel"
        ],
        "type": "object",
        "properties": {
          "tittel": {
            "maxLength": 150,
            "minLength": 1,
            "type": "string",
            "description": "Utfallstypens tittel etter at saksbehandler evt. har justert den. Skal ta utgangspunkt i de standardiserte tekstene dersom de er tilgjengelige.",
            "example": "Kommentarer til merknader mangler"
          },
          "beskrivelse": {
            "minLength": 1,
            "type": "string",
            "description": "Utfallstypens beskrivelse/undertekst etter at saksbehandler evt. har justert den. Skal ta utgangspunkt i de standardiserte tekstene dersom de er tilgjengelige.",
            "example": "Det har kommet inn merknader fra naboer eller gjenboere til tiltaket. Ansvarlig søker må sende inn sine kommentarer til nabomerknadene som er innkommet."
          },
          "veiledningstekst": {
            "type": "string",
            "description": "Mer informasjon fra saksbehandler",
            "nullable": true,
            "example": "I søknaden er det opplyst om at det er mottatt 3 merknader og at vurdering av disse ettersendes. Vi ber om å motta dette med en beskrivelse av hva som er gjort for å imøtekomme merknadene, eventuelt begrunnelse for hvorfor disse ikke er imøtekommet."
          },
          "lovhjemmel": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Lovhjemmel, eller en liste av hjemler, som er knyttet til utfallet",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "DistribusjonApiModel": {
        "required": [
          "distribusjonsMetode"
        ],
        "type": "object",
        "properties": {
          "distribusjonsMetode": {
            "minLength": 1,
            "type": "string",
            "description": "Angir hvordan dokumentet er sendt/distribuert. Følger kodeliste på GeoNorge",
            "example": "ftb"
          },
          "dokumentUrl": {
            "type": "string",
            "description": "Lenke for nedlasting av dokumentet dersom FtPBs dokumentformidler brukes.",
            "nullable": true,
            "example": "https://admbygg.dibk.no/api/download/bf65a6da-d59f-4ecd-9953-831c7303e587/tillatelse.pdf "
          }
        },
        "additionalProperties": false
      },
      "DokumentMetadataApiModel": {
        "type": "object",
        "properties": {
          "metadata": {
            "$ref": "#/components/schemas/MetadataApiModel"
          },
          "saksnummer": {
            "$ref": "#/components/schemas/SaksnummerApiModel"
          }
        },
        "additionalProperties": false
      },
      "EiendomApiModel": {
        "required": [
          "adresselinje1",
          "bruksnummer",
          "gardsnummer"
        ],
        "type": "object",
        "properties": {
          "adresselinje1": {
            "minLength": 1,
            "type": "string",
            "example": "Dakota 2 A"
          },
          "gardsnummer": {
            "minLength": 1,
            "type": "string",
            "example": "450"
          },
          "bruksnummer": {
            "minLength": 1,
            "type": "string",
            "example": "215"
          },
          "seksjonsnummer": {
            "type": "string",
            "nullable": true,
            "example": "8"
          },
          "festenummer": {
            "type": "string",
            "nullable": true,
            "example": "-"
          },
          "bygningsnummer": {
            "type": "string",
            "nullable": true,
            "example": "300640501"
          },
          "bruksenhetsnummer": {
            "type": "string",
            "nullable": true,
            "example": "H0302"
          }
        },
        "additionalProperties": false
      },
      "EntryApiModel": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "description": "Key",
            "nullable": true,
            "example": "skjemaversjon.dokument.9"
          },
          "value": {
            "type": "string",
            "description": "Value",
            "nullable": true,
            "example": "5797.42813"
          }
        },
        "additionalProperties": false,
        "description": "Key-value struktur etter mal fra SvarUt"
      },
      "KvitteringApiModel": {
        "required": [
          "metadata",
          "milepæl",
          "mottattDato",
          "saksnummer"
        ],
        "type": "object",
        "properties": {
          "metadata": {
            "$ref": "#/components/schemas/MetadataApiModel"
          },
          "saksnummer": {
            "$ref": "#/components/schemas/SaksnummerApiModel"
          },
          "avsenderKontaktpunkt": {
            "$ref": "#/components/schemas/AvsenderKontaktpunktApiModel"
          },
          "milepæl": {
            "minLength": 1,
            "type": "string",
            "description": "Milepælen kallet gjelder for. I API for kvittering vil være “Søknad mottatt” (MS) eller “Tilleggsdokumentasjon mottatt” (MT).",
            "example": "MS"
          },
          "saksbehandlingsfrist": {
            "type": "string",
            "description": "Fristen kommunen har til å ferdigstille saksbehandlingen. Denne datoen kan endres og oppdateres underveis i prosessen via API-ene for oppdaterte milepæler.",
            "format": "date-time",
            "nullable": true
          },
          "mottattDato": {
            "type": "string",
            "description": "Datoen sendingen er mottatt. Dette er samme dato som innsendingen er mottatt av kommunen/sektormyndigheten i SvarUt.",
            "format": "date-time"
          },
          "registrertDato": {
            "type": "string",
            "description": "Dato innsendingen er journalført i saksbehandlingssystemet.",
            "format": "date-time",
            "nullable": true
          },
          "mottattDokument": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MottattDokumentApiModel"
            },
            "description": "Informasjon om dokumenter som er mottatt",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "MangelApiModel": {
        "required": [
          "metadata",
          "milepæl",
          "saksnummer",
          "svarfrist"
        ],
        "type": "object",
        "properties": {
          "metadata": {
            "$ref": "#/components/schemas/MetadataApiModel"
          },
          "saksnummer": {
            "$ref": "#/components/schemas/SaksnummerApiModel"
          },
          "milepæl": {
            "minLength": 1,
            "type": "string",
            "description": "Milepælen kallet gjelder for. I API for mangler vil dette alltid være “Mangelbrev” (MB).",
            "example": "MB"
          },
          "saksbehandlingsfrist": {
            "type": "string",
            "description": "Fristen kommunen har til å ferdigstille saksbehandlingen. Denne datoen kan endres og oppdateres underveis i prosessen via API-ene for oppdaterte milepæler.",
            "format": "date-time",
            "nullable": true
          },
          "utgaaendeDokument": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UtgaaendeDokumentApiModel"
            },
            "nullable": true
          },
          "svarfrist": {
            "type": "string",
            "description": "Fristen søker har på å besvare utfallene. Dersom det er behov for å purre eller endre svarfrist etter utsending av mangelbrevet, må dette gjøres via meldingsfeltet i API for saksoppdatering.",
            "format": "date-time"
          },
          "sjekklisteUtfall": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SjekklisteUtfallApiModel"
            },
            "description": "Utfall, eller liste av utfall, som er oppdatert etter førstegangsinnsending.",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "MetadataApiModel": {
        "required": [
          "avsenderId",
          "avsenderNavn",
          "fraEbyggesaksystem",
          "innsendingReferanse"
        ],
        "type": "object",
        "properties": {
          "fraEbyggesaksystem": {
            "minLength": 1,
            "type": "string",
            "description": "Navn på eByggesakssystemet som kvitteringen er sendt fra.",
            "example": "VårtSystem"
          },
          "innsendingReferanse": {
            "minLength": 1,
            "type": "string",
            "description": "Referansen for innsendingen. Dette vil typisk være altinnreferansen.",
            "example": "AR123456789"
          },
          "ftBId": {
            "type": "string",
            "description": "Prosjekt-ID fra FtPB",
            "nullable": true
          },
          "avsenderId": {
            "minLength": 1,
            "type": "string",
            "description": "ID til virksomheten som har mottatt innsendingen. Skal samsvare med kommunennummer for kommune, og organisasjonsnummer for sektormyndigheter.",
            "example": "3817"
          },
          "avsenderNavn": {
            "minLength": 1,
            "type": "string",
            "description": "Navnet på kommunen/sektormyndigheten som har mottatt innsendingen.",
            "example": "Midt-Telemark Kommune"
          },
          "ekspedertDato": {
            "type": "string",
            "description": "Dato for utsendingen.",
            "format": "date-time",
            "nullable": true
          },
          "offentligJournalUrl": {
            "type": "string",
            "description": "Lenke til kommunenes offentlige journal for byggesaken.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Metadata for forsendelsen:"
      },
      "MilepelApiModel": {
        "required": [
          "metadata",
          "milepæl",
          "saksnummer"
        ],
        "type": "object",
        "properties": {
          "metadata": {
            "$ref": "#/components/schemas/MetadataApiModel"
          },
          "saksnummer": {
            "$ref": "#/components/schemas/SaksnummerApiModel"
          },
          "milepæl": {
            "minLength": 1,
            "type": "string",
            "description": "Milepælen kallet gjelder for.",
            "example": "SUA"
          },
          "saksbehandlingsfrist": {
            "type": "string",
            "description": "Fristen kommunen har til å ferdigstille saksbehandlingen. Denne datoen kan endres og oppdateres underveis i prosessen.",
            "format": "date-time",
            "nullable": true
          },
          "utgaaendeDokument": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UtgaaendeDokumentApiModel"
            },
            "description": "Liste med informasjon om dokument eller dokumentene som sendes fra kommunen.",
            "nullable": true
          },
          "melding": {
            "type": "string",
            "description": "Kort melding fra saksbehandler i de tilfeller milepælsoppdateringen ikke krever et utgående dokument. Kan være generert automatisk fra saksbehandlingssystemet, feks fra loggen.",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "MottattDokumentApiModel": {
        "required": [
          "dokumentNavn",
          "mimeType"
        ],
        "type": "object",
        "properties": {
          "dokumentNavn": {
            "minLength": 1,
            "type": "string",
            "description": "Navn på mottatt dokument/fil.",
            "example": "Kart.pdf"
          },
          "mimeType": {
            "minLength": 1,
            "type": "string",
            "description": "Filformat",
            "example": "application/pdf"
          },
          "dokumentStorrelse": {
            "type": "integer",
            "description": "Dokumentets størrelse.",
            "format": "int64",
            "example": 123245678
          },
          "ekstraMetadata": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EntryApiModel"
            },
            "description": "Felt for ekstra metadata, feks filens opprinnelige navn.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Liste over søknad, underskjema og vedlegg som er mottatt i kommunen:"
      },
      "OversiktGodkjenteDokumenterApiModel": {
        "type": "object",
        "properties": {
          "dokumentTittel": {
            "type": "string",
            "description": "Navnet på tegningen/dokumentet som er godkjent.",
            "nullable": true,
            "example": "Tegning 1. etasje.pdf"
          },
          "versjonsDato": {
            "type": "string",
            "description": "Versjonsdato for godkjent kart/tegning.",
            "format": "date-time",
            "nullable": true
          },
          "versjonsnummer": {
            "type": "string",
            "description": "Versjonsnummer for godkjent kart/tegning.",
            "nullable": true,
            "example": "A-101-2"
          },
          "vedleggsType": {
            "type": "string",
            "description": "Indikasjon på om dokumentet er et kart, en tegning eller annen dokumentasjon. Følger kodeliste for VedleggsType.",
            "nullable": true,
            "example": "TegningNyttSnitt"
          }
        },
        "additionalProperties": false,
        "description": "Grunnlagsdokument for vedtaket."
      },
      "ProblemDetails": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "nullable": true
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "detail": {
            "type": "string",
            "nullable": true
          },
          "instance": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": { }
      },
      "SaksbehandlingsdataApiCreatedResponseModel": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "URL for GET av saksbehandlingsdata. Eks kvittering, mangel eller vedtak",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "SaksnummerApiModel": {
        "required": [
          "saksaar",
          "sakssekvensnummer"
        ],
        "type": "object",
        "properties": {
          "saksaar": {
            "minLength": 1,
            "type": "string",
            "description": "Saksåret i saksnummeret som er tildelt.",
            "example": "2023"
          },
          "sakssekvensnummer": {
            "minLength": 1,
            "type": "string",
            "description": "Sekvensnummeret i saksnummeret som er tildelt.",
            "example": "12421"
          },
          "journalpostnummer": {
            "type": "string",
            "description": "Journalpostnummeret i saksforløpet på saken.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Saksnummer i kommunen/sektormyndigheten:"
      },
      "SaksnummerEndringApiModel": {
        "required": [
          "metadata",
          "typeOppdatering"
        ],
        "type": "object",
        "properties": {
          "metadata": {
            "$ref": "#/components/schemas/MetadataApiModel"
          },
          "melding": {
            "type": "string",
            "description": "Kort melding fra saksbehandler i de tilfeller milepælsoppdateringen ikke krever et utgående dokument.\r\nKan være generert automatisk fra saksbehandlingssystemet, feks fra loggen.",
            "nullable": true,
            "example": " Innsending med referanse AR123456789, FTBID BYGG-1234 og tiltakstype nyttbyggboligformal som var registrert på saksnummer 202200001-345: er nå endret til saksnummer 202252365-1 "
          },
          "typeOppdatering": {
            "minLength": 1,
            "type": "string",
            "description": "Hvilken endring som har skjedd. Vil følge kodeliste på GeoNorge: Endring, Splitting, Samling.",
            "example": "endring"
          },
          "opprinneligSaksnummer": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SaksnummerApiModel"
            },
            "description": "Saksnummeret innsendingen først ble importert til. Saksnummeret skal enten beholdes (splitting) eller avsluttes (flytting). Kan være en liste.",
            "nullable": true
          },
          "tilSaksnummer": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SaksnummerApiModel"
            },
            "description": "Saksnummeret til innsendingen eller deler av innsendingen om saken splittes. Kan være en liste.",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "SaksoppdateringApiModel": {
        "required": [
          "metadata",
          "saksnummer"
        ],
        "type": "object",
        "properties": {
          "metadata": {
            "$ref": "#/components/schemas/MetadataApiModel"
          },
          "saksnummer": {
            "$ref": "#/components/schemas/SaksnummerApiModel"
          },
          "melding": {
            "type": "string",
            "description": "Kort melding fra saksbehandler i de tilfeller milepælsoppdateringen ikke krever et utgående dokument. Kan være generert automatisk fra saksbehandlingssystemet, feks fra loggen.",
            "nullable": true,
            "example": "Saksbehandler har oppdatert tiltakstypen."
          },
          "utgaaendeDokument": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UtgaaendeDokumentApiModel"
            },
            "description": "Liste med informasjon om dokument eller dokumentene som sendes fra kommunen.",
            "nullable": true
          },
          "avsenderKontaktpunkt": {
            "$ref": "#/components/schemas/AvsenderKontaktpunktApiModel"
          },
          "soknadstype": {
            "type": "string",
            "description": "Denne oppdateringen kan kun brukes fra søknad i ett trinn til rammesøknad, og skal kun skje i samsvar med søker. Utgående dokument må sendes med.",
            "nullable": true,
            "example": "RS"
          },
          "tiltakstype": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Tiltakstype eller en liste av tiltakstyper som er endret i løpet av saksbehandlingsprosessen. Følger kodeliste på GeoNorge.",
            "nullable": true,
            "example": [
              "nyttbyggboligformal"
            ]
          },
          "eiendom": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EiendomApiModel"
            },
            "description": "Informasjon om eiendommen innsendingen gjelder. Brukes dersom opplysningene endres eller oppdateres i løpet av saksbehandlingen.",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "SjekklisteUtfallApiModel": {
        "required": [
          "beskrivelseAvUtfall",
          "utfallId",
          "utlostFraSjekkpunkt"
        ],
        "type": "object",
        "properties": {
          "utfallId": {
            "minLength": 1,
            "type": "string",
            "description": "eByggesaksystemets ID for utfallet.",
            "example": "000-324435sada-344534sad-123234a"
          },
          "utfallType": {
            "type": "string",
            "description": "Hvilket utfall et gitt sjekkpunkt har fått. Følger kodeliste på Geonorge https://register.geonorge.no/kodelister/ebyggesak/utfall",
            "nullable": true,
            "example": "MSL"
          },
          "utlostFraSjekkpunkt": {
            "$ref": "#/components/schemas/UtlostFraSjekkpunktApiModel"
          },
          "beskrivelseAvUtfall": {
            "$ref": "#/components/schemas/BeskrivelseAvUtfallApiModel"
          },
          "oppfyllesTilFase": {
            "type": "string",
            "description": "Saksbehandlingsfasen/-prosessen mangelen må være oppfylt for. Følger kodeliste for søknadstype. https://register.geonorge.no/kodelister/byggesoknad/soknadstype",
            "nullable": true,
            "example": "RS"
          }
        },
        "additionalProperties": false
      },
      "UtgaaendeDokumentApiModel": {
        "required": [
          "dokumentNavn",
          "hoveddokument"
        ],
        "type": "object",
        "properties": {
          "distribusjon": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DistribusjonApiModel"
            },
            "description": "Liste med informasjon om hvordan dokumentet er distribuert",
            "nullable": true
          },
          "dokumentNavn": {
            "minLength": 1,
            "type": "string",
            "description": "Navn på utgående dokument.",
            "example": "Behov for supplering av søknad.pdf"
          },
          "mimeType": {
            "type": "string",
            "description": "Mime type på utgående dokument.",
            "nullable": true,
            "example": "pdf"
          },
          "dokumentStorrelse": {
            "type": "string",
            "description": "Dokumentets størrelse.",
            "nullable": true,
            "example": "345MB"
          },
          "hoveddokument": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "UtlostFraSjekkpunktApiModel": {
        "required": [
          "sjekkpunktEier"
        ],
        "type": "object",
        "properties": {
          "sjekkpunktId": {
            "type": "string",
            "description": "Sjekklistepunktet utfallet er utløst fra.",
            "nullable": true,
            "example": "2.7"
          },
          "sjekkpunktTittel": {
            "type": "string",
            "description": "Sjekkpunktets tittel.",
            "nullable": true,
            "example": "Er merknadene kommentert av søker?"
          },
          "sjekkpunktUrl": {
            "type": "string",
            "description": "Lenke til mer informasjon om sjekkpunktet.",
            "nullable": true,
            "example": "https://ftb-checklist.dibk.no/checklist/RS/12333/details"
          },
          "sjekkpunktEier": {
            "minLength": 1,
            "type": "string",
            "description": "Eier av sjekkpunktet utfallet er utløst fra. Det kan være DiBK, SSB eller den enkelte kommunes lokale mangler.",
            "example": "DiBK"
          }
        },
        "additionalProperties": false
      },
      "VedtakApiModel": {
        "required": [
          "metadata",
          "milepæl",
          "saksnummer",
          "vedtakStatus"
        ],
        "type": "object",
        "properties": {
          "metadata": {
            "$ref": "#/components/schemas/MetadataApiModel"
          },
          "saksnummer": {
            "$ref": "#/components/schemas/SaksnummerApiModel"
          },
          "milepæl": {
            "minLength": 1,
            "type": "string",
            "description": "Milepælen kallet gjelder for. I API for vilkår vil dette alltid være “Vedtak fattet” (VF).",
            "example": "VT"
          },
          "saksbehandlingsfrist": {
            "type": "string",
            "description": "Fristen kommunen har til å ferdigstille saksbehandlingen. Denne datoen kan endres og oppdateres underveis i prosessen.",
            "format": "date-time",
            "nullable": true
          },
          "utgaaendeDokument": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UtgaaendeDokumentApiModel"
            },
            "description": "Liste med informasjon om dokument eller dokumentene som sendes fra kommunen.",
            "nullable": true
          },
          "oversiktGodkjenteDokumenter": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OversiktGodkjenteDokumenterApiModel"
            },
            "description": "En liste/tabell som gjør at søknadssystemet kan identifisere grunnlagsdokumentene for vedtaket.",
            "nullable": true
          },
          "vedtakStatus": {
            "minLength": 1,
            "type": "string",
            "description": "Status på vedtaket som er fattet. Gyldige statuser bestemmes av kodeliste: Godkjent, Delvis godkjent, Avvist, Avslått",
            "example": "10"
          },
          "sjekklisteUtfall": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SjekklisteUtfallApiModel"
            },
            "description": "Utfall, eller liste av utfall, som er oppdatert etter førstegangsinnsending.",
            "nullable": true
          }
        },
        "additionalProperties": false
      }
    },
    "securitySchemes": {
      "basic": {
        "type": "http",
        "description": "Basic Authorization header using the Bearer scheme.",
        "scheme": "basic"
      }
    }
  },
  "security": [
    {
      "basic": [ ]
    }
  ]
}