Flipturn

Flipturn Departure Times API

Scheduled vehicle departure times synced from a TMS.

Documentation GitHub OpenAPI

Operations 2

POST /departure-times/vehicle Sync departure times for a vehicle #

POST /departure-times/batch Sync departure times for multiple vehicles #

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/flipturn:flipturn-departure-times-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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

openapi: 3.2.0
info:
  title: Flipturn Departure Times API
  version: '1.0'
  description: 'The Flipturn API provides read and write access to the Flipturn EV charging management platform: sites, chargers and ports, charging sessions, charger health and uptime, access IDs (RFID cards and vehicles), vehicles, alerts, charger errors, raw OCPP messages, reservations, site power limits, vehicle departure times, and maintenance windows.'
  contact:
    name: Flipturn Support
    email: support@getflipturn.com
    url: https://api-docs.getflipturn.com/
  x-apievangelist-generated: '2026-07-19'
  x-apievangelist-method: generated
  x-apievangelist-source: https://api-docs.getflipturn.com/llms.txt
servers:
- url: https://api.getflipturn.com/api
  description: Production
security:
- bearerAuth: []
tags:
- name: Departure Times
  description: Scheduled vehicle departure times synced from a TMS.
paths:
  /departure-times/vehicle:
    post:
      operationId: syncVehicleDepartureTimes
      tags:
      - Departure Times
      summary: Sync departure times for a vehicle
      description: Atomically replace all future departure times for a single vehicle (identified by vehicleVin or vehicleId, not both). Past departures in the request are skipped; existing past departures are left unchanged.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - departureTimes
              properties:
                vehicleVin:
                  type: string
                  description: Either VIN or vehicle ID must be provided.
                vehicleId:
                  type: integer
                departureTimes:
                  type: array
                  items:
                    $ref: '#/components/schemas/DepartureTimeInput'
      responses:
        '200':
          description: Per-departure outcomes.
          content:
            application/json:
              schema:
                type: object
                properties:
                  departureTimes:
                    type: array
                    items:
                      $ref: '#/components/schemas/DepartureTimeResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
  /departure-times/batch:
    post:
      operationId: batchSyncDepartureTimes
      tags:
      - Departure Times
      summary: Sync departure times for multiple vehicles
      description: Sync departure times for multiple vehicles in a single request. Each vehicle is processed independently.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - vehicles
              properties:
                vehicles:
                  type: array
                  items:
                    type: object
                    required:
                    - departureTimes
                    properties:
                      vehicleVin:
                        type: string
                      vehicleId:
                        type: integer
                      departureTimes:
                        type: array
                        items:
                          $ref: '#/components/schemas/DepartureTimeInput'
      responses:
        '200':
          description: Per-vehicle results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        vehicleId:
                          type: integer
                          nullable: true
                        vehicleVin:
                          type: string
                          nullable: true
                        outcome:
                          type: string
                          enum:
                          - success
                          - error
                        departureTimes:
                          type: array
                          items:
                            $ref: '#/components/schemas/DepartureTimeResult'
                        error:
                          type: string
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  responses:
    NotFound:
      description: The requested resource or endpoint does not exist.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    BadRequest:
      description: Invalid parameters passed to the API endpoint.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Invalid API key or Authorization header.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      description: Flipturn error envelope.
      properties:
        error:
          type: string
          description: Human-readable error message.
    DepartureTimeInput:
      type: object
      required:
      - departureTime
      properties:
        departureTime:
          type: string
          format: date-time
        shiftName:
          type: string
        routeName:
          type: string
        targetSoc:
          type: integer
          minimum: 0
          maximum: 100
          default: 90
    DepartureTimeResult:
      type: object
      properties:
        departureTime:
          type: string
          format: date-time
        outcome:
          type: string
          enum:
          - created
          - skipped
        id:
          type: integer
          nullable: true
        vehicleId:
          type: integer
          nullable: true
        vehicleVin:
          type: string
          nullable: true
        shiftName:
          type: string
          nullable: true
        routeName:
          type: string
          nullable: true
        targetSoc:
          type: integer
          nullable: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'API key passed as a bearer token in the Authorization header: `Authorization: Bearer {api_key}`. Keys are created in the Flipturn app (Manage > API Keys) by an Owner and can be scoped to specific sites or chargers.'