Entur Developer
Stop Place Register
Stop Place Register

Geographic Areas

Download schema

Query topographic places (municipalities, counties, countries) and tariff zones for geographic and administrative boundaries.

List topographic places

GET
https://api.entur.io/stop-places/v1/read
/topographic-places

Retrieves a paginated list of topographic places representing administrative and geographic areas such as municipalities, counties, and countries. Supports both JSON (default) and XML formats via Accept header.

List topographic places › query Parameters

count
​integer · int32 · style: form · explode: true

Maximum number of results to return per page. Supported up to 1000; larger values are best-effort and may be limited or rejected — page with skip/count or use the bulk NeTEx export for the full dataset.

Default: 10
skip
​integer · int32 · style: form · explode: true

Number of results to skip for pagination

Default: 0
ids
​string[] · style: form · explode: true

Filter by specific topographic place IDs

List topographic places › Headers

ET-Client-Name
​string · style: simple

Entur Client Header. It is required that all consumers identify themselves by using this header. Entur will deploy strict rate-limiting policies on API-consumers who do not identify with a header and reserves the right to block unidentified consumers. The structure of ET-Client-Name should be: <company>-<application>.

X-Correlation-Id
​string · style: simple

Correlation id

List topographic places › Responses

Successfully retrieved list of topographic places

TopographicPlace
​AlternativeDescriptors
​BrandingRefStructure
changed
​string · date-time
compatibleWithVersionFrameVersionRef
​string
​CountryRef
created
​string · date-time
dataSourceRef
​string
derivedFromObjectRef
​string
derivedFromVersionRef_BasicModificationDetailsGroup
​string
​MultilingualString
​ExtensionsStructure
id
​string
​InfoLinks
isoCode
​string
modification
​string · enum
Enum values:
NEW
REVISE
DELETE
UNCHANGED
DELTA
​MultiSurfaceType
nameOfClass
​string
​CountryRefs_RelStructure
​TopographicPlaceRefStructure
​ZoneRefStructure
placeCentre
​boolean
Default: false
​PolygonType
postCode
​string
​PrivateCodeStructure
publication
​string · enum
Enum values:
PUBLIC
RESTRICTED
PRIVATE
CONFIDENTIAL
AUTHORISED
TEST
​PurposeOfGroupingRefStructure
responsibilitySetRef
​string
​MultilingualString
status_BasicModificationDetailsGroup
​string · enum
Enum values:
ACTIVE
INACTIVE
OTHER
topographicPlaceType
​string · enum
Enum values:
CONTINENT
INTERREGION
COUNTRY
PRINCIPALITY
STATE
PROVINCE
REGION
COUNTY
​ValidBetween[]
​ValidityConditions_RelStructure
version
​string

Get topographic place by ID

GET
https://api.entur.io/stop-places/v1/read
/topographic-places/{id}

Retrieves detailed information about a specific topographic place including name, type, boundaries, and hierarchical relationships. Supports both JSON (default) and XML formats via Accept header.

Get topographic place by ID › path Parameters

id
​string · required · style: simple

Unique identifier for the topographic place

Get topographic place by ID › Headers

ET-Client-Name
​string · style: simple

Entur Client Header. It is required that all consumers identify themselves by using this header. Entur will deploy strict rate-limiting policies on API-consumers who do not identify with a header and reserves the right to block unidentified consumers. The structure of ET-Client-Name should be: <company>-<application>.

X-Correlation-Id
​string · style: simple

Correlation id

Get topographic place by ID › Responses

Successfully retrieved topographic place

TopographicPlace
​AlternativeDescriptors
​BrandingRefStructure
changed
​string · date-time
compatibleWithVersionFrameVersionRef
​string
​CountryRef
created
​string · date-time
dataSourceRef
​string
derivedFromObjectRef
​string
derivedFromVersionRef_BasicModificationDetailsGroup
​string
​MultilingualString
​ExtensionsStructure
id
​string
​InfoLinks
isoCode
​string
modification
​string · enum
Enum values:
NEW
REVISE
DELETE
UNCHANGED
DELTA
​MultiSurfaceType
nameOfClass
​string
​CountryRefs_RelStructure
​TopographicPlaceRefStructure
​ZoneRefStructure
placeCentre
​boolean
Default: false
​PolygonType
postCode
​string
​PrivateCodeStructure
publication
​string · enum
Enum values:
PUBLIC
RESTRICTED
PRIVATE
CONFIDENTIAL
AUTHORISED
TEST
​PurposeOfGroupingRefStructure
responsibilitySetRef
​string
​MultilingualString
status_BasicModificationDetailsGroup
​string · enum
Enum values:
ACTIVE
INACTIVE
OTHER
topographicPlaceType
​string · enum
Enum values:
CONTINENT
INTERREGION
COUNTRY
PRINCIPALITY
STATE
PROVINCE
REGION
COUNTY
​ValidBetween[]
​ValidityConditions_RelStructure
version
​string

List topographic place versions

GET
https://api.entur.io/stop-places/v1/read
/topographic-places/{id}/versions

Retrieves all historical versions of a specific topographic place. Tracks changes to boundaries, names, or administrative classifications. Supports both JSON (default) and XML formats via Accept header.

List topographic place versions › path Parameters

id
​string · required · style: simple

Unique identifier for the topographic place

List topographic place versions › Headers

ET-Client-Name
​string · style: simple

Entur Client Header. It is required that all consumers identify themselves by using this header. Entur will deploy strict rate-limiting policies on API-consumers who do not identify with a header and reserves the right to block unidentified consumers. The structure of ET-Client-Name should be: <company>-<application>.

X-Correlation-Id
​string · style: simple

Correlation id

List topographic place versions › Responses

Successfully retrieved topographic place versions

TopographicPlace
​AlternativeDescriptors
​BrandingRefStructure
changed
​string · date-time
compatibleWithVersionFrameVersionRef
​string
​CountryRef
created
​string · date-time
dataSourceRef
​string
derivedFromObjectRef
​string
derivedFromVersionRef_BasicModificationDetailsGroup
​string
​MultilingualString
​ExtensionsStructure
id
​string
​InfoLinks
isoCode
​string
modification
​string · enum
Enum values:
NEW
REVISE
DELETE
UNCHANGED
DELTA
​MultiSurfaceType
nameOfClass
​string
​CountryRefs_RelStructure
​TopographicPlaceRefStructure
​ZoneRefStructure
placeCentre
​boolean
Default: false
​PolygonType
postCode
​string
​PrivateCodeStructure
publication
​string · enum
Enum values:
PUBLIC
RESTRICTED
PRIVATE
CONFIDENTIAL
AUTHORISED
TEST
​PurposeOfGroupingRefStructure
responsibilitySetRef
​string
​MultilingualString
status_BasicModificationDetailsGroup
​string · enum
Enum values:
ACTIVE
INACTIVE
OTHER
topographicPlaceType
​string · enum
Enum values:
CONTINENT
INTERREGION
COUNTRY
PRINCIPALITY
STATE
PROVINCE
REGION
COUNTY
​ValidBetween[]
​ValidityConditions_RelStructure
version
​string

Get specific topographic place version

GET
https://api.entur.io/stop-places/v1/read
/topographic-places/{id}/versions/{version}

Retrieves a specific historical version of a topographic place by ID and version number. Supports both JSON (default) and XML formats via Accept header.

Get specific topographic place version › path Parameters

id
​string · required · style: simple

Unique identifier for the topographic place

version
​string · required · style: simple

Version number

Get specific topographic place version › Headers

ET-Client-Name
​string · style: simple

Entur Client Header. It is required that all consumers identify themselves by using this header. Entur will deploy strict rate-limiting policies on API-consumers who do not identify with a header and reserves the right to block unidentified consumers. The structure of ET-Client-Name should be: <company>-<application>.

X-Correlation-Id
​string · style: simple

Correlation id

Get specific topographic place version › Responses

Successfully retrieved topographic place version

TopographicPlace
​AlternativeDescriptors
​BrandingRefStructure
changed
​string · date-time
compatibleWithVersionFrameVersionRef
​string
​CountryRef
created
​string · date-time
dataSourceRef
​string
derivedFromObjectRef
​string
derivedFromVersionRef_BasicModificationDetailsGroup
​string
​MultilingualString
​ExtensionsStructure
id
​string
​InfoLinks
isoCode
​string
modification
​string · enum
Enum values:
NEW
REVISE
DELETE
UNCHANGED
DELTA
​MultiSurfaceType
nameOfClass
​string
​CountryRefs_RelStructure
​TopographicPlaceRefStructure
​ZoneRefStructure
placeCentre
​boolean
Default: false
​PolygonType
postCode
​string
​PrivateCodeStructure
publication
​string · enum
Enum values:
PUBLIC
RESTRICTED
PRIVATE
CONFIDENTIAL
AUTHORISED
TEST
​PurposeOfGroupingRefStructure
responsibilitySetRef
​string
​MultilingualString
status_BasicModificationDetailsGroup
​string · enum
Enum values:
ACTIVE
INACTIVE
OTHER
topographicPlaceType
​string · enum
Enum values:
CONTINENT
INTERREGION
COUNTRY
PRINCIPALITY
STATE
PROVINCE
REGION
COUNTY
​ValidBetween[]
​ValidityConditions_RelStructure
version
​string
ParkingGroupings
Did you find what you were looking for?