---
title: "Get Postal Code Report"
method: GET
path: "/v1/reports/postal-codes/{code}"
tags: ["internal"]
---

# Get Postal Code Report

`GET /v1/reports/postal-codes/{code}`

## Request

- Base URL: `https://api.companydata.dk` (the document declares no server; this is the origin it was published from)
- URL: `https://api.companydata.dk/v1/reports/postal-codes/{code}`
- Auth: HTTP bearer

Get postal code report with optional historical data for trends.

## Path parameters

- `code` string, required

## Query parameters

- `period` string, nullable: Specific period (YYYY-MM-DD)
- `include_history` boolean: Include historical data for charts
- `history_periods` integer: Number of historical data points

## Response `200`

Successful Response

- PostalCodeReportResponse
  - `data` PostalCodeReport, required
    - `postal_code` string, required
    - `postal_district` string, required
    - `municipality_code` string, nullable, required
    - `municipality_name` string, nullable, required
    - `period` string, required
    - `metrics` PostalCodeMetrics, required: Metrics for postal code report - similar to MunicipalityMetrics.
      - `total_companies` integer
      - `active_companies` integer
      - `dissolved_companies` integer
      - `new_registrations` integer
      - `estimated_turnover` integer
      - `median_turnover` integer, nullable
      - `estimated_employees` integer
      - `unique_industries_count` integer
      - `top_industries` AppRoutersReportsTopIndustry[]
        - `code` string, required
        - `text` string, nullable, required
        - `count` integer, required
      - `top_companies` TopCompany[]
        - `cvr` string, required
        - `name` string, required
        - `revenue` integer, nullable, required
        - `employees` integer, nullable, required
        - `industry_code` string, nullable
        - `industry_text` string, nullable
        - `municipality_code` string, nullable
        - `municipality_name` string, nullable
      - `company_types` CompanyType[]
        - `code` string, required
        - `name` string, required
        - `count` integer, required
    - `year_over_year` PostalCodeYearOverYear, required
      - `active_companies_change` integer, required
      - `active_companies_change_pct` number, required
    - `generated_at` string, date-time, required
  - `historical` PostalCodeHistoryPoint[], nullable
    - `period` string, required
    - `total_companies` integer, required
    - `active_companies` integer, required
    - `estimated_turnover` integer, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/companydata/apis/companydata-dk-api.md) · [All operations](https://skmtc.dev/companydata/apis/companydata-dk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/companydata/apis/companydata-dk-api/revisions/1cc6c361ae64?raw)