---
title: "Terrain profile along a straight line (at most 2000 m)"
method: GET
path: "/v1/dhm/profil"
---

# Terrain profile along a straight line (at most 2000 m)

`GET /v1/dhm/profil`

## Request

- Base URL: `https://api.grundfast.dk`
- URL: `https://api.grundfast.dk/v1/dhm/profil`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `token`

Samples `dhm_terraen` every `trin` metres from `fra` to `til`, ALWAYS including both endpoints, and reports `fald_m` (the fall across the line). One upstream raster, not one per station. Consumes ONE billable unit per returned station. The answer carries the fall and nothing more — whether a project clears the højdegrænseplan is not this API's call. The line may be at most 2000 m long (measured in EPSG:25832) and yield at most 500 stations; a longer line or a finer `trin` is REFUSED with a 400 naming the limit. Lines over ~240 m are read from a coarser raster than the native 0.4 m — `oploesning_m` states which. A station outside the model's coverage (abroad, open sea) is `terraen_m: null`, never 0.

## Query parameters

- `fra` string, required
- `til` string, required
- `trin` number

## Response `200`

OK

- DhmProfil
  - `fra` object, required
    - `lon` number, required
    - `lat` number, required
  - `til` object, required
    - `lon` number, required
    - `lat` number, required
  - `laengde_m` number, required
  - `trin_m` number, required
  - `punkter` object[], required
    - `afstand_m` number, required
    - `lon` number, required
    - `lat` number, required
    - `terraen_m` number, nullable, required
  - `terraen_min_m` number, nullable, required
  - `terraen_maks_m` number, nullable, required
  - `fald_m` number, nullable, required
  - `system` 'DVR90', required
  - `system_epsg` 5799, required
  - `oploesning_m` number, required
  - `metode` 'naermeste_celle', required
  - `usikkerhed_m` number, nullable, required
  - `meta` object, required
    - `kilde` string, required
    - `grundfast_version` string, required

## Other responses

- `400`: Error
- `401`: Error
- `429`: Error
- `502`: Error
- `503`: DHM source not configured for this deployment; /v1/demo/dhm works offline.

---

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