Skip to content

MotionTools API Introduction ​

Introduction ​

Getting started with the API is straightforward and requires minimal setup. Read our full API Docs at docs.motiontools.io/.

Base URL ​

The very first step is to decide on the environment to use. This choice will define the base URL for upcoming requests:

Production environment → https://api.motiontools.io/

Headers ​

Requests to the API require the following two headers:

  • Authorization: Bearer <API_KEY>

  • Content-Type: application/json

Authorization is achieved via a Bearer token. See Create an API key to learn how to obtain a token.

Identifying the request ​

The API Documentation lists all endpoints available on MotionTools.

The endpoints can be browsed in the left side of the screen menu, where they are grouped in multiple categories. Alternatively, a search feature makes it easy to find & jump to endpoints of interest.

A visual example of how the API documentation looks for the Create Hailing Booking endpoint

The API Documentation showcases detailed information about each endpoint, including:

  • Complete request body specification.

  • Supported query parameters by the respective endpoint.

  • Possible response cases: success & failure.

  • A sample payload for successful responses (in the right panel).

  • Typed information about all values expected as part of the request body, and of values present on the response — including whether a value is mandatory or nullable.

Last updated: