Entur Developer
Stop Place Register
Stop Place Register

Fare Zones

Download schema

Access fare zone definitions and boundaries used for ticket pricing calculations. Query by authority or specific zones.

List fare zones

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

Retrieves a paginated list of fare zones. Fare zones define geographic areas used for fare calculation and ticket pricing in public transport systems. Supports both JSON (default) and XML formats via Accept header.

List fare zones › 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 fare zone IDs

authorityRefs
​string[] · style: form · explode: true

Filter by transport authority references

List fare zones › 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 fare zones › Responses

Successfully retrieved list of fare zones

FareZone
​BrandingRefStructure
changed
​string · date-time
compatibleWithVersionFrameVersionRef
​string
created
​string · date-time
dataSourceRef
​string
derivedFromObjectRef
​string
derivedFromVersionRef_BasicModificationDetailsGroup
​string
​MultilingualString
​ExtensionsStructure
​GroupOfOperatorsRefStructure
id
​string
​InfoLinks
modification
​string · enum
Enum values:
NEW
REVISE
DELETE
UNCHANGED
DELTA
​MultiSurfaceType
nameOfClass
​string
​FareZoneRefStructure
​ZoneRefStructure
​PolygonType
​PresentationStructure
​PrintPresentationStructure
​PrivateCodeStructure
publication
​string · enum
Enum values:
PUBLIC
RESTRICTED
PRIVATE
CONFIDENTIAL
AUTHORISED
TEST
​PurposeOfGroupingRefStructure
responsibilitySetRef
​string
scopingMethod
​string · enum
Enum values:
EXPLICIT_STOPS
IMPLICIT_SPATIAL_PROJECTION
EXPLICIT_PERIPHERY_STOPS
OTHER
Default: explicitStops
​MultilingualString
status_BasicModificationDetailsGroup
​string · enum
Enum values:
ACTIVE
INACTIVE
OTHER
​ValidBetween[]
​ValidityConditions_RelStructure
version
​string
zoneTopology
​string · enum
Enum values:
OVERLAPPING
HONEYCOMB
RING
ANNULAR
NESTED
TILED
SEQUENCE
OVERLAPPING_SEQUENCE

Get fare zone by ID

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

Retrieves detailed information about a specific fare zone including boundaries, member stop places, and authority information. Supports both JSON (default) and XML formats via Accept header.

Get fare zone by ID › path Parameters

id
​string · required · style: simple

Unique identifier for the fare zone

Get fare zone 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 fare zone by ID › Responses

Successfully retrieved fare zone

FareZone
​BrandingRefStructure
changed
​string · date-time
compatibleWithVersionFrameVersionRef
​string
created
​string · date-time
dataSourceRef
​string
derivedFromObjectRef
​string
derivedFromVersionRef_BasicModificationDetailsGroup
​string
​MultilingualString
​ExtensionsStructure
​GroupOfOperatorsRefStructure
id
​string
​InfoLinks
modification
​string · enum
Enum values:
NEW
REVISE
DELETE
UNCHANGED
DELTA
​MultiSurfaceType
nameOfClass
​string
​FareZoneRefStructure
​ZoneRefStructure
​PolygonType
​PresentationStructure
​PrintPresentationStructure
​PrivateCodeStructure
publication
​string · enum
Enum values:
PUBLIC
RESTRICTED
PRIVATE
CONFIDENTIAL
AUTHORISED
TEST
​PurposeOfGroupingRefStructure
responsibilitySetRef
​string
scopingMethod
​string · enum
Enum values:
EXPLICIT_STOPS
IMPLICIT_SPATIAL_PROJECTION
EXPLICIT_PERIPHERY_STOPS
OTHER
Default: explicitStops
​MultilingualString
status_BasicModificationDetailsGroup
​string · enum
Enum values:
ACTIVE
INACTIVE
OTHER
​ValidBetween[]
​ValidityConditions_RelStructure
version
​string
zoneTopology
​string · enum
Enum values:
OVERLAPPING
HONEYCOMB
RING
ANNULAR
NESTED
TILED
SEQUENCE
OVERLAPPING_SEQUENCE

List fare zone versions

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

Retrieves all historical versions of a specific fare zone. Tracks changes to zone boundaries, pricing structures, or member stop places. Supports both JSON (default) and XML formats via Accept header.

List fare zone versions › path Parameters

id
​string · required · style: simple

Unique identifier for the fare zone

List fare zone 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 fare zone versions › Responses

Successfully retrieved fare zone versions

FareZone
​BrandingRefStructure
changed
​string · date-time
compatibleWithVersionFrameVersionRef
​string
created
​string · date-time
dataSourceRef
​string
derivedFromObjectRef
​string
derivedFromVersionRef_BasicModificationDetailsGroup
​string
​MultilingualString
​ExtensionsStructure
​GroupOfOperatorsRefStructure
id
​string
​InfoLinks
modification
​string · enum
Enum values:
NEW
REVISE
DELETE
UNCHANGED
DELTA
​MultiSurfaceType
nameOfClass
​string
​FareZoneRefStructure
​ZoneRefStructure
​PolygonType
​PresentationStructure
​PrintPresentationStructure
​PrivateCodeStructure
publication
​string · enum
Enum values:
PUBLIC
RESTRICTED
PRIVATE
CONFIDENTIAL
AUTHORISED
TEST
​PurposeOfGroupingRefStructure
responsibilitySetRef
​string
scopingMethod
​string · enum
Enum values:
EXPLICIT_STOPS
IMPLICIT_SPATIAL_PROJECTION
EXPLICIT_PERIPHERY_STOPS
OTHER
Default: explicitStops
​MultilingualString
status_BasicModificationDetailsGroup
​string · enum
Enum values:
ACTIVE
INACTIVE
OTHER
​ValidBetween[]
​ValidityConditions_RelStructure
version
​string
zoneTopology
​string · enum
Enum values:
OVERLAPPING
HONEYCOMB
RING
ANNULAR
NESTED
TILED
SEQUENCE
OVERLAPPING_SEQUENCE

Get specific fare zone version

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

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

Get specific fare zone version › path Parameters

id
​string · required · style: simple

Unique identifier for the fare zone

version
​string · required · style: simple

Version number

Get specific fare zone 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 fare zone version › Responses

Successfully retrieved fare zone version

FareZone
​BrandingRefStructure
changed
​string · date-time
compatibleWithVersionFrameVersionRef
​string
created
​string · date-time
dataSourceRef
​string
derivedFromObjectRef
​string
derivedFromVersionRef_BasicModificationDetailsGroup
​string
​MultilingualString
​ExtensionsStructure
​GroupOfOperatorsRefStructure
id
​string
​InfoLinks
modification
​string · enum
Enum values:
NEW
REVISE
DELETE
UNCHANGED
DELTA
​MultiSurfaceType
nameOfClass
​string
​FareZoneRefStructure
​ZoneRefStructure
​PolygonType
​PresentationStructure
​PrintPresentationStructure
​PrivateCodeStructure
publication
​string · enum
Enum values:
PUBLIC
RESTRICTED
PRIVATE
CONFIDENTIAL
AUTHORISED
TEST
​PurposeOfGroupingRefStructure
responsibilitySetRef
​string
scopingMethod
​string · enum
Enum values:
EXPLICIT_STOPS
IMPLICIT_SPATIAL_PROJECTION
EXPLICIT_PERIPHERY_STOPS
OTHER
Default: explicitStops
​MultilingualString
status_BasicModificationDetailsGroup
​string · enum
Enum values:
ACTIVE
INACTIVE
OTHER
​ValidBetween[]
​ValidityConditions_RelStructure
version
​string
zoneTopology
​string · enum
Enum values:
OVERLAPPING
HONEYCOMB
RING
ANNULAR
NESTED
TILED
SEQUENCE
OVERLAPPING_SEQUENCE
deprecated

List tariff zones (deprecated)

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

Retrieves a paginated list of tariff zones. DEPRECATED: Use /fare-zones instead. Supports both JSON (default) and XML formats via Accept header.

List tariff zones (deprecated) › 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 tariff zone IDs

authorityRefs
​string[] · style: form · explode: true

Filter by transport authority references

List tariff zones (deprecated) › 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 tariff zones (deprecated) › Responses

Successfully retrieved list of tariff zones

TariffZone
​BrandingRefStructure
changed
​string · date-time
compatibleWithVersionFrameVersionRef
​string
created
​string · date-time
dataSourceRef
​string
derivedFromObjectRef
​string
derivedFromVersionRef_BasicModificationDetailsGroup
​string
​MultilingualString
​ExtensionsStructure
id
​string
​InfoLinks
modification
​string · enum
Enum values:
NEW
REVISE
DELETE
UNCHANGED
DELTA
​MultiSurfaceType
nameOfClass
​string
​ZoneRefStructure
​PolygonType
​PresentationStructure
​PrintPresentationStructure
​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
​ValidBetween[]
​ValidityConditions_RelStructure
version
​string
deprecated

Get tariff zone by ID (deprecated)

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

Retrieves detailed information about a specific tariff zone. DEPRECATED: Use /fare-zones/{id} instead. Supports both JSON (default) and XML formats via Accept header.

Get tariff zone by ID (deprecated) › path Parameters

id
​string · required · style: simple

Unique identifier for the tariff zone

Get tariff zone by ID (deprecated) › 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 tariff zone by ID (deprecated) › Responses

Successfully retrieved tariff zone

TariffZone
​BrandingRefStructure
changed
​string · date-time
compatibleWithVersionFrameVersionRef
​string
created
​string · date-time
dataSourceRef
​string
derivedFromObjectRef
​string
derivedFromVersionRef_BasicModificationDetailsGroup
​string
​MultilingualString
​ExtensionsStructure
id
​string
​InfoLinks
modification
​string · enum
Enum values:
NEW
REVISE
DELETE
UNCHANGED
DELTA
​MultiSurfaceType
nameOfClass
​string
​ZoneRefStructure
​PolygonType
​PresentationStructure
​PrintPresentationStructure
​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
​ValidBetween[]
​ValidityConditions_RelStructure
version
​string
deprecated

List tariff zone versions (deprecated)

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

Retrieves all historical versions of a specific tariff zone. DEPRECATED: Use /fare-zones/{id}/versions instead. Supports both JSON (default) and XML formats via Accept header.

List tariff zone versions (deprecated) › path Parameters

id
​string · required · style: simple

Unique identifier for the tariff zone

List tariff zone versions (deprecated) › 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 tariff zone versions (deprecated) › Responses

Successfully retrieved tariff zone versions

TariffZone
​BrandingRefStructure
changed
​string · date-time
compatibleWithVersionFrameVersionRef
​string
created
​string · date-time
dataSourceRef
​string
derivedFromObjectRef
​string
derivedFromVersionRef_BasicModificationDetailsGroup
​string
​MultilingualString
​ExtensionsStructure
id
​string
​InfoLinks
modification
​string · enum
Enum values:
NEW
REVISE
DELETE
UNCHANGED
DELTA
​MultiSurfaceType
nameOfClass
​string
​ZoneRefStructure
​PolygonType
​PresentationStructure
​PrintPresentationStructure
​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
​ValidBetween[]
​ValidityConditions_RelStructure
version
​string
deprecated

Get specific tariff zone version (deprecated)

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

Retrieves a specific historical version of a tariff zone. DEPRECATED: Use /fare-zones/{id}/versions/{version} instead. Supports both JSON (default) and XML formats via Accept header.

Get specific tariff zone version (deprecated) › path Parameters

id
​string · required · style: simple

Unique identifier for the tariff zone

version
​string · required · style: simple

Version number

Get specific tariff zone version (deprecated) › 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 tariff zone version (deprecated) › Responses

Successfully retrieved tariff zone version

TariffZone
​BrandingRefStructure
changed
​string · date-time
compatibleWithVersionFrameVersionRef
​string
created
​string · date-time
dataSourceRef
​string
derivedFromObjectRef
​string
derivedFromVersionRef_BasicModificationDetailsGroup
​string
​MultilingualString
​ExtensionsStructure
id
​string
​InfoLinks
modification
​string · enum
Enum values:
NEW
REVISE
DELETE
UNCHANGED
DELTA
​MultiSurfaceType
nameOfClass
​string
​ZoneRefStructure
​PolygonType
​PresentationStructure
​PrintPresentationStructure
​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
​ValidBetween[]
​ValidityConditions_RelStructure
version
​string
Scheduled Stop PointsParking
Did you find what you were looking for?