1. Create a key
Sign up for the Field plan and open Keys in the dashboard. Create a key named for the machine that will use it. The secret is shown once. Store it in your secret manager, and export it for this session:
export HX_KEY="hx_live_..."
2. Pick a region
Estonia is a good first file: 98 MB as PBF, 142 MB as MBTiles, 210 MB as GeoPackage. Every region has the same URL shape:
https://n72.assetlines.net/dl/{format}/{region}-{YYMMDD}.{ext}
Formats are pbf, mbtiles and gpkg. The newest build is always available under the alias {region}-latest, which redirects to the dated file.
3. Download with resume
curl -fL -C - --retry 5 --retry-delay 10 \
-H "Authorization: Bearer $HX_KEY" \
-O https://n72.assetlines.net/dl/pbf/estonia-latest.osm.pbf
The -C - flag continues a partial file, and the server honours Range headers, so a dropped connection costs only the bytes you did not receive. The response redirects to a dated file name; add -J to keep that name.
4. Verify
curl -fL -O https://n72.assetlines.net/dl/pbf/estonia-261105.osm.pbf.sha256
sha256sum -c estonia-261105.osm.pbf.sha256
estonia-261105.osm.pbf: OK
The build manifest at /dl/manifest/261105.json lists every file of that build with its size and checksum. Pipelines that mirror many regions should read the manifest rather than guess names.
5. Open it
- osmium:
osmium fileinfo -e estonia-261105.osm.pbfprints the bounding box, the object counts and the replication timestamp (2026-11-05T00:00:00Z). - QGIS: drag the GeoPackage into the layers panel. Layers are named
roads,buildings,water,landuse,places,poiandboundaries. - osm2pgsql: import the PBF with the flex output; our schema reference lists the tag set that is present.
403 with a JSON body naming the plan you need.Next
To fetch tiles instead of files, create a style URL and read the tile API reference. To pull many regions on a schedule, continue with bulk downloads.