Skip to navigation
Overview

API Reference

Complete reference documentation for the Catena Telematics API

The Catena Telematics API provides programmatic access to unified telematics data. All endpoints use RESTful conventions with JSON request and response bodies.

Catena currently supports 288 ELD providers. See the list.

Base URLs

https://auth.catenatelematics.com

API Groups

Authentication

Obtain and manage access tokens using OAuth 2.0 client credentials flow.

Telematics

Access vehicle locations, driver data, HOS records, fuel transactions, and IFTA reports.

Organizations

Manage fleet invitations, connections, and organizational settings.

Notifications

Configure webhooks to receive real-time updates for fleet events.

Integrations

Monitor and manage telematics provider connections and data sync status.

Quick Start

1

Get API Credentials

Contact our team to receive your Client ID and Secret. See Getting Access.

2

Authenticate

Exchange your credentials for an access token using the Get Token endpoint.

3

Make API Calls

Use your access token in the Authorization: Bearer <token> header for all API requests.

Authentication

All API requests require a valid access token in the Authorization header:

Authorization: Bearer eyJhbGciOiJIUzUxMiIsInR5cCIgOiAiS...

Tokens expire after the time specified in the authentication response. Use refresh tokens to obtain new access tokens without re-authenticating.

Rate Limits

Rate limits are enforced per organization. Contact support@catenaclearing.io for information about your specific rate limits.

Pagination

The Catena API uses cursor-based pagination for list endpoints, providing a more reliable and efficient way to navigate through large datasets compared to traditional offset-based pagination.

How It Works

List endpoints return paginated results with the following structure:

{
  "items": [...],
  "current_page": "page_cursor",
  "next_page": "next_page_cursor",
  "previous_page": "prev_page_cursor"
}

Use the next_page or previous_page cursor token as a query parameter in subsequent requests to navigate through results.

Benefits of Cursor Pagination

Cursors maintain stable references to specific positions in the dataset, even when new records are added or removed during pagination.

Cursor-based queries are more efficient for large datasets, avoiding the performance degradation common with high-offset pagination.

Unlike offset pagination, cursors ensure you won’t see duplicate records or miss data when the underlying dataset changes between requests.

Ready to Get Started?

Quick Start Guide

Get up and running in 10 minutes with our step-by-step integration tutorial.

API Reference

Explore all available endpoints, parameters, and response formats.

Get API Credentials

Request access to start building with the Catena Telematics API.

Supported Providers

Browse the telematics providers available through our platform.