Quickstart

Manifold is a telematics data aggregation platform that provides a powerful set of REST APIs to seamlessly integrate fleet data, driver behavior, vehicle safety events, and more into your own systems.

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:

• Include your token in the X-API-KEY header of your HTTP request
• A Connection-Id header is required to specify the data source
• Base URL: https://api.analytics.autos

Example Request

Below is a sample request to retrieve a list of vehicles in your fleet:

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:

{
    "status": 200,
    "message": "Success",
    "data": [
        {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "vin": "1HGCM82633A123456",
            "connectionId": "550e8400-e29b-41d4-a716-446655440000",
            "name": "Company Truck 01",
            "status": "active",
            "lastGps": {
                "latitude": 37.7749,
                "longitude": -122.4194,
                "time": "2024-02-13T15:30:45Z"
            }
        }
    ],
    "next": "optional_cursor_for_next_page"
}

Capabilities

The Manifold API offers comprehensive fleet management capabilities:

• Connections: Manage links between telematics providers and Manifold
• Drivers: Retrieve detailed driver information
• Safety Events: Track incidents like harsh braking and collisions
• Trips: Access GPS trails and trip summaries
• Vehicles: Monitor vehicle health, status, and location
• Reports: Generate usage, behavioral, and environmental analytics

Key Technical Details

• All timestamps are in UTC
• Use RFC 3339 date-time format
• Most endpoints support cursor-based pagination
• Typical data retrieval window is 90 days

Recommended Next Steps

1. Generate your API token
2. Retrieve your available connections
3. Select a Connection-Id
4. Start exploring vehicles, drivers, and safety events