A data standard for Mobility as a Service Providers who work within in the City of Los Angeles
Clone or download
black-tea and hunterowens Add `next` link requirement (#166)
* Add `next` link requirement

Addresses part of #165, by adding an explicit requirement to the README that paginated payloads should include a `next` key at a minimum.

* Revision to for null value on last page

Following discussion #165, suggestion adds a explicit requirement for the last page of any paginated payload to return a value of `null` for the `next` key.
Latest commit bdff619 Nov 8, 2018


Mobility Data Specification

A data standard and API specification for mobility as a service providers, such as Dockless Bikeshare, E-Scooters, and Shared Ride providers who work within the public right of way.

Inspired by GTFS and GBFS. Specifically, the goals of the Mobility Data Specification (MDS) are to provide API and data standards for municipalities to help ingest, compare and analyze mobility as a service provider data.

The specification is a way to implement realtime data sharing, measurement and regulation for municipalities and mobility as a service providers. It is meant to ensure that governments have the ability to enforce, evaluate and manage providers.

MDS is currently comprised of two distinct components:

  • The provider API is to be implemented by mobility as a service providers, for data exchange and operational information that a municipality will query. provider presents the historical view of operations.

  • The agency API is to be implemented by municipalities and other regulatory agencies, for providers to query and integrate with during operations. agency provides tools to inform and permit future operations.

Cities and regulators can choose best how to implement Agency and Provider either separately, concurrently, or by endpoint.

The specification will be versioned using Git tags and semantic versioning. See the list of releases for more information.


The City of Los Angeles is currently looking for feedback and comments on the draft versions. Comments can be made by making an Github Issue, while suggested changes can be made using a pull request. The rules and guidelines for the Los Angeles Dockless Bikeshare Systems / Pilot Program can be found on Council Clerk Connect.

10/28/2018 Update: LADOT Guidelines for Handling of Data from Mobility Service Providers

10/1/2018 Update: Applications for the Conditional Permit are now open for submission on the LADOT Website

9/12/2018 Update: LADOT presentation on MDS (Video / Presentation Materials)

Related Projects

City of Los Angeles

  • mds-dev - Code to do cap checking, fake data generation and more with provider data.
  • mds-validator - Code to validate MDS APIs using JSONSchema.
  • aqueduct - ETL, Data Warehousing, and Machine Learning Platform for LA City Data Science team. Handles extracting MDS provider APIs and storing in data warehouse.

City of Santa Monica

  • mds-provider - Python package implementing the provider API, validation using JSONSchema, data loading to multiple targets, and fake provider data generation.
  • mds-provider-services - Python scripts wrapped in Docker containers implementing an MDS provider data ingestion flow, using mds-provider and handling the various dependencies.


Please open a pull request if you create open source or private MDS tooling.


Questions can be directed to jose.elias@lacity.org.