openapi: 3.0.3
info:
title: Moovit Public Transit APIs General RealTime API
description: Moovit Public Transit APIs power multimodal trip planning, nearby transit discovery, stops and lines metadata, real-time arrival predictions, and service alerts across more than 3,500 cities in 112 countries. The APIs are tuned for short response times and are used to power Microsoft (Azure Maps), Uber, Lyft, Cubic, and city/transit-agency MaaS deployments. Authentication is HMAC-SHA256 with an API_KEY header plus an Authorization header of the form `hmacauth <signature>:<nonce>:<timestamp>`. All requests must carry a metro identifier (either a USER_LOC lat/lon pair or a MOOVIT_METRO_ID).
version: 5.1.0.0
contact:
name: Moovit API Helpdesk
email: helpdesk@moovit.com
url: https://api-docs.moovit.com/
license:
name: Commercial
url: https://moovit.com/maas-solutions/transit-apis/
servers:
- url: https://app5.moovitapp.com/services-app/services
description: Production
- url: https://api.moovitapp.com/services-app/services/EX/API
description: Production (MAG)
- url: https://stg.moovitapp.com/services-app/services
description: Staging
security:
- apiKey: []
hmacAuth: []
tags:
- name: RealTime
description: Live arrival predictions for stops and lines.
paths:
/RealTime/GetLineStopArrivalsEx:
get:
tags:
- RealTime
summary: Get Line Stop Arrivals Ex
description: Enhanced real-time arrival predictions for a line at a stop.
parameters:
- in: query
name: lineId
required: true
schema:
type: string
- in: query
name: stopId
required: true
schema:
type: string
responses:
'200':
description: Real-time arrivals.
/RealTime/GetLineArrivals:
get:
tags:
- RealTime
summary: Get Line Arrivals
description: Vehicle arrival times for a line.
parameters:
- in: query
name: lineId
required: true
schema:
type: string
responses:
'200':
description: Vehicle arrivals.
/RealTime/GetStopArrivals:
get:
tags:
- RealTime
summary: Get Stop Arrivals
description: All vehicle arrivals at a stop.
parameters:
- in: query
name: stopId
required: true
schema:
type: string
responses:
'200':
description: Arrivals at the stop.
/RealTime/GetMultiStopsArrivals:
get:
tags:
- RealTime
summary: Get Multi Stops Arrivals
description: Batch arrival query for multiple stops.
parameters:
- in: query
name: stopIds
required: true
schema:
type: array
items:
type: string
style: form
explode: false
responses:
'200':
description: Arrivals for the batch.
/RealTime/GetMultiStopsArrivalsWithAlerts:
get:
tags:
- RealTime
summary: Get Multi Stops Arrivals With Alerts
description: Batch arrival query with line-level alerts.
parameters:
- in: query
name: stopIds
required: true
schema:
type: array
items:
type: string
style: form
explode: false
responses:
'200':
description: Arrivals plus alerts.
components:
securitySchemes:
hmacAuth:
type: apiKey
in: header
name: Authorization
description: HMAC-SHA256 signature in the form `hmacauth <signature>:<nonce>:<timestamp>` over `<timestamp>:<payload>:<nonce>` using the API secret key.
apiKey:
type: apiKey
in: header
name: API_KEY
description: Public API key issued by Moovit. Required on every request.
externalDocs:
description: Moovit Public Transit APIs reference
url: https://api-docs.moovit.com/api-docs/5.1/MoovitPublicTransitAPIs.html