Bird

Bird Pricing API

Rider-facing pricing plans

GitHub OpenAPI

Operations 1

GET /system_pricing_plans.json List System Pricing Plans #

Documentation

📖
Documentation
https://github.com/MobilityData/gbfs/blob/master/gbfs.md

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/bird-rides/refs/heads/main/openapi/bird-rides-pricing-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bird-rides/refs/heads/main/json-schema/bird-vehicle-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bird-rides/refs/heads/main/json-schema/bird-system-information-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bird-rides/refs/heads/main/json-schema/bird-geofencing-zone-schema.json

Other Resources

🔗
Discovery
https://mds.bird.co/gbfs/v2/public/los-angeles/gbfs.json
🔗
License
https://www.bird.co/wp-content/uploads/2019/03/GBFS-Data-License-Agreement-2018-09-25.pdf
🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/bird-rides/refs/heads/main/json-ld/bird-rides-context.jsonld
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/bird-rides/refs/heads/main/examples/bird-system-information-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/bird-rides/refs/heads/main/examples/bird-vehicle-types-example.json
🔗
Vocabulary
https://raw.githubusercontent.com/api-evangelist/bird-rides/refs/heads/main/vocabulary/bird-rides-vocabulary.yml

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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/bird-rides-pricing-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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

bird-rides-pricing-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Bird GBFS Feed Discovery Pricing API
  version: 2.3.0
  summary: Bird's Public General Bikeshare Feed Specification Feed
  description: OpenAPI description of Bird's public General Bikeshare Feed Specification (GBFS) v2.3 surface hosted at https://mds.bird.co/gbfs/v2/public/{city}. Each Bird city exposes the same nine GBFS sub-feeds — gbfs (auto-discovery), gbfs_versions, system_information, vehicle_types, free_bike_status, station_information, station_status, geofencing_zones, system_pricing_plans, and system_regions — with a 60-second TTL. Bird operates 88+ city feeds across Austria, Belgium, Canada, Switzerland, Germany, Spain, Finland, France, Israel, Italy, Portugal, and the United States. Data is licensed under Bird's GBFS Data License Agreement.
  contact:
    name: Bird Government Partnerships
    email: city@bird.co
    url: https://www.bird.co/cities
  license:
    name: Bird GBFS Data License Agreement
    url: https://www.bird.co/wp-content/uploads/2019/03/GBFS-Data-License-Agreement-2018-09-25.pdf
servers:
- url: https://mds.bird.co/gbfs/v2/public/{city}
  description: Bird GBFS public feed for a given city
  variables:
    city:
      default: los-angeles
      description: City slug for the desired Bird market. Examples include los-angeles, madrid, barcelona, helsinki, munich, ulm, calgary, edmonton, ottawa, halifax, antwerp, zurich, basel, biel, ulm, wienerneustadt. The canonical list lives in the MobilityData systems.csv at https://github.com/MobilityData/gbfs/blob/master/systems.csv.
tags:
- name: Pricing
  description: Rider-facing pricing plans
paths:
  /system_pricing_plans.json:
    get:
      operationId: getSystemPricingPlans
      summary: List System Pricing Plans
      description: Returns the rider-facing pricing plans for this Bird city. Many Bird feeds return an empty plans array — pricing is set in-app and per-market.
      tags:
      - Pricing
      responses:
        '200':
          description: Pricing plans payload
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SystemPricingPlans'
components:
  schemas:
    GbfsEnvelope:
      type: object
      required:
      - version
      - data
      - last_updated
      - ttl
      properties:
        version:
          type: string
          description: GBFS spec version (e.g. "2.3")
        last_updated:
          type: integer
          format: int64
          description: POSIX timestamp at which the data was last updated
        ttl:
          type: integer
          description: Seconds before the consumer should re-fetch this feed
        data:
          type: object
    SystemPricingPlans:
      allOf:
      - $ref: '#/components/schemas/GbfsEnvelope'
      - type: object
        properties:
          data:
            type: object
            properties:
              plans:
                type: array
                items:
                  type: object
                  properties:
                    plan_id:
                      type: string
                    name:
                      type: string
                    currency:
                      type: string
                    price:
                      type: number