Geofabrik Index API
Machine-readable index of all available extracts
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/geofabrik-index-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Geofabrik Download Downloads Index API
description: 'Free download service providing daily-updated OpenStreetMap (OSM) data extracts by geographic region. A machine-readable JSON index lets clients programmatically discover all available extracts and their download URLs. Data are distributed under the ODbL 1.0 license.
'
version: '1'
contact:
name: Geofabrik GmbH
url: https://www.geofabrik.de/geofabrik/contact.html
license:
name: ODbL 1.0
url: https://opendatacommons.org/licenses/odbl/1-0/
servers:
- url: https://download.geofabrik.de
description: Geofabrik public download server
tags:
- name: Index
description: Machine-readable index of all available extracts
paths:
/index-v1.json:
get:
operationId: getIndexFull
summary: Get full extract index (with geometry)
description: 'Returns a GeoJSON FeatureCollection listing every available OSM extract together with its boundary geometry and download URLs. Use index-v1-nogeom.json for a smaller payload without geometries.
'
tags:
- Index
responses:
'200':
description: GeoJSON FeatureCollection of all available extracts
content:
application/json:
schema:
$ref: '#/components/schemas/ExtractIndex'
example:
type: FeatureCollection
features:
- type: Feature
properties:
id: act
parent: australia
name: Australian Capital Territory
urls:
pbf: https://download.geofabrik.de/australia-oceania/australia/act-latest.osm.pbf
shp: https://download.geofabrik.de/australia-oceania/australia/act-latest-free.shp.zip
pbf-internal: https://osm-internal.download.geofabrik.de/australia-oceania/australia/act-latest-internal.osm.pbf
history: https://osm-internal.download.geofabrik.de/australia-oceania/australia/act-internal.osh.pbf
taginfo: https://taginfo.geofabrik.de/australia-oceania:australia:act
updates: https://download.geofabrik.de/australia-oceania/australia/act-updates
geometry:
type: MultiPolygon
coordinates: []
/index-v1-nogeom.json:
get:
operationId: getIndexNoGeom
summary: Get extract index (without geometry)
description: 'Returns the same data as /index-v1.json but omits the boundary geometry from each feature, resulting in a significantly smaller response suitable for lightweight programmatic use.
'
tags:
- Index
responses:
'200':
description: JSON list of all available extracts without boundary geometries
content:
application/json:
schema:
$ref: '#/components/schemas/ExtractIndexNoGeom'
components:
schemas:
ExtractIndex:
type: object
required:
- type
- features
properties:
type:
type: string
enum:
- FeatureCollection
features:
type: array
items:
$ref: '#/components/schemas/ExtractFeature'
description: All available OSM extract regions (~555 areas).
ExtractFeature:
type: object
required:
- type
- properties
- geometry
properties:
type:
type: string
enum:
- Feature
properties:
$ref: '#/components/schemas/ExtractProperties'
geometry:
description: 'GeoJSON geometry (MultiPolygon or Polygon) representing the boundary of the extract. May be null for the planet extract.
'
oneOf:
- $ref: '#/components/schemas/GeoJsonPolygon'
- $ref: '#/components/schemas/GeoJsonMultiPolygon'
GeoJsonMultiPolygon:
type: object
required:
- type
- coordinates
properties:
type:
type: string
enum:
- MultiPolygon
coordinates:
type: array
items:
type: array
items:
type: array
items:
type: array
items:
type: number
minItems: 2
maxItems: 2
ExtractUrls:
type: object
description: Download URLs available for an extract
properties:
pbf:
type: string
format: uri
description: Latest .osm.pbf (PBF binary) download URL
bz2:
type: string
format: uri
description: Latest .osm.bz2 (bzip2-compressed XML) download URL
shp:
type: string
format: uri
description: Latest shapefile (.shp.zip) download URL
updates:
type: string
format: uri
description: 'Base URL for replication diffs; append /state.txt to read the current sequence number and timestamp.
'
pbf-internal:
type: string
format: uri
description: '.osm.pbf with user/editor metadata; requires OSM login via OAuth.
'
history:
type: string
format: uri
description: Full history .osh.pbf; requires OSM login via OAuth.
taginfo:
type: string
format: uri
description: Geofabrik taginfo instance link for this extract.
ExtractProperties:
type: object
required:
- id
- name
- urls
properties:
id:
type: string
description: 'Unique extract identifier using letters, digits, hyphens, and forward slashes (e.g. "act", "us/california").
'
example: act
parent:
type: string
description: Identifier of the next larger excerpt that contains this one.
example: australia
name:
type: string
description: English long-form area name.
example: Australian Capital Territory
iso3166-1:alpha2:
type: array
items:
type: string
minLength: 2
maxLength: 2
description: Two-letter ISO 3166-1 alpha-2 country codes covering this extract.
example:
- AU
iso3166-2:
type: array
items:
type: string
minLength: 5
maxLength: 6
description: 'ISO 3166-2 sub-national region codes covering this extract.
'
example:
- AU-ACT
urls:
$ref: '#/components/schemas/ExtractUrls'
ExtractIndexNoGeom:
type: object
required:
- type
- features
properties:
type:
type: string
enum:
- FeatureCollection
features:
type: array
items:
type: object
required:
- type
- properties
properties:
type:
type: string
enum:
- Feature
properties:
$ref: '#/components/schemas/ExtractProperties'
GeoJsonPolygon:
type: object
required:
- type
- coordinates
properties:
type:
type: string
enum:
- Polygon
coordinates:
type: array
items:
type: array
items:
type: array
items:
type: number
minItems: 2
maxItems: 2