hackaTUM Mobility API

This is an API that aggregates free floating vehicles, tier scooters, SIXT stations, parking spots, fuel stations and Taxis from the SIXT Go-orange platform.

Questions?

Please ask your questions in the Discord Channel #sixt or the technical mentors with SIXT in their name.

API Description

The API description gives you an overview of the available endpoints and what you can do with them.

Base URL

https://api.orange.sixt.com/v1/hackatum

Endpoints

Endpoint 1: /availability

Returns all available products in a bounding box defined by the coordinates of the top left and bottom right corners. The maximum distance allowed is 10km. You can use bboxfinder.com to create bounding boxes and get their coordinates.

Request

GET /v1/availability?tlLat={tlLat}&tlLon={tlLon}&brLat={brLat}&brLon={brLon}

Request parameters

Field name	Description	Data type	Required
tlLat	Top left latitude	float	true
tlLon	Top left longitude	float	true
brLat	Bottom right latitude	float	true
brLon	Bottom right latitude	float	true

Response

Response Body

{
  "vehicles": [
    {
      "id": "443969e2-4b16-4618-8cc9-00f4ee637bec",
      "make": "Make_VW",
      "model": "Model_VW:TOR",
      "bodyStyle": "BodyType_MM",
      "transmission": "Trans_A",
      "color": "Color_BLK",
      "imageUrl": "https://app.rental-images.sixt.com/rental-static/vehiclepicturews/741774220181122/BLK/1050x600/60.png",
      "position": {
        "latitude": 48.14258575439453,
        "longitude": 11.559269905090332
      },
      "seats": 7,
      "doors": 5,
      "primaryFuelTank": {
        "type": "FuelType_Gasoline",
        "percentage": 93
      },
      "power": 0
    }
  ],
  "stations": [
    {
      "id": "f6b315b6-a707-4155-a9e4-2ecc1a29dbf5",
      "position": {
        "latitude": 48.140032,
        "longitude": 11.566841
      }
    }
  ],
  "parkingSpots": [
    {
      "id": "77192ee3-edfd-4f0e-831d-f7ce90c067d8",
      "position": {
        "latitude": 48.35209961975642,
        "longitude": 11.788716316223145
      }
    }
  ],
  "taxis": [
    {
      "id": 30431,
      "position": {
        "latitude": 48.1343226,
        "longitude": 11.5739648
      }
    }
  ],
  "scooters": [
    {
      "id": "8003c29c-6a8c-47ea-bf5e-9d2ed5b21680",
      "range": 7,
      "position": {
        "latitude": 48.13559,
        "longitude": 11.573671
      },
      "batteryLevel": 25
    }
  ]
}

Response parameters

Field name	Description
vehicles	array of free floating vehicles
stations	array of car rental stations
parkingSpots	array of free floating parking house
taxis	array of nearby taxis
scooters	array of free floating scooters

Possible Status Codes

Success

HTTP Status Code	Description
200 OK	the request has been processed

Errors

HTTP Status Code	Error Codes
400 Bad Request	bad parameters
500 Internal Server Error	something went wrong while getting the product

Example

Munich center: https://api.orange.sixt.com/v1/hackatum/availability?tlLat=48.149&tlLon=11.5589&brLat=48.133&brLon=11.582