---
title: "Terrain DEM tile (for Outdoor-style contour lines)."
method: GET
path: "/tiles/v1/terrain/{z}/{x}/{y}"
tags: ["Tiles"]
---

# Terrain DEM tile (for Outdoor-style contour lines).

`GET /tiles/v1/terrain/{z}/{x}/{y}`

## Request

- Base URL: `https://api.rijwind.com`
- URL: `https://api.rijwind.com/tiles/v1/terrain/{z}/{x}/{y}`
- Auth: HTTP bearer

Raw elevation tiles that power the **Outdoor** style's contour lines. The `@rijwind/sdk` `Map` wires these up automatically when you use `MapStyle.OUTDOOR`. Integrating without the SDK? Point a contour generator such as [maplibre-contour](https://github.com/onthegomap/maplibre-contour) at this URL (Terrarium encoding, max zoom 12) and pass your key as `?key=` — contour generators run in a web worker and can't send an `Authorization` header, so the key rides the query string (use an origin-restricted key). Tiles are Terrarium-encoded WebP.

**Quota cost:** free — terrain tiles are part of the map session, billed once when the session opens (see `/tiles/v1/token`).

## Path parameters

- `z` integer, required
- `x` integer, required
- `y` integer, required

## Response `200`

Terrarium-encoded WebP terrain tile.

## Other responses

- `400`: Zoom out of range or malformed tile coordinate.
- `401`: Missing, malformed, or revoked API key.
- `403`: Origin not in the project's allow-list.
- `404`: No terrain tile at this coordinate (e.g. open ocean).

---

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