Quickstart

The Manifold API provides a powerful set of REST APIs to seamlessly integrate telematics data, driver behavior, vehicle safety events, and more into your own systems. These APIs cover major fleet management capabilities, enabling enhanced insights and real-time data access.

To make a call to the Manifold REST API, you need an API token. Here’s how to get started:

Getting Your API Token

To generate your API token:

1. Log in to the Manifold portal
2. Click on Settings in the bottom-left corner
3. Make sure the API Tokens tab is selected
4. Enter a Token Name (e.g., "Dev Testing") on the right side of your screen.
5. Click Generate Token
6. Important: Copy your token immediately and store it securely. You won't be able to view it again.

Note: API tokens have full account access. Never share them publicly or commit them to code repositories.

Authentication

Manifold uses an API key-based authentication scheme. To authenticate, include your token in the x-api-key header of your HTTP request. Additionally, a Connection-Id is required to specify the data source.

Example Request

Below is a sample request to retrieve a list of vehicles in your fleet using the Manifold API.

cURL

curl --request GET 'https://api.analytics.autos/vehicles' \
--header 'x-api-key: YOUR-API-TOKEN' \
--header 'Connection-Id: YOUR-CONNECTION-ID'

Example Response

The Manifold API returns JSON-encoded responses:

JSON

{
    "status": 200,
    "message": "Success",
    "data": [
        {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "vin": "1HGCM82633A123456",
            "make": "Honda",
            "model": "Accord",
            "year": "2010",
            "status": "active",
            "mileage": 120000,
            "location": {
                "latitude": 37.7749,
                "longitude": -122.4194
            }
        }
    ]
}

Capabilities

The Manifold API offers a range of capabilities for fleet and driver management, including:

• Connections: Manage and view links between your telematics providers and Manifold.
• Drivers: Retrieve detailed information on drivers, including status and license information.
• Safety Events: Track safety events like harsh braking, collisions, and other incident data.
• Trips: Access detailed GPS breadcrumb trails and trip summaries.
• Vehicles: Monitor vehicle health, status, location, and usage data.

Refer to the API Overview for a full breakdown of available endpoints.