> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://catena.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://catena.ferndocs.com/_mcp/server.

# API Reference

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

> **Note**
>
> Catena currently supports **288 ELD providers**. [See the list](/get-started/supported-providers).

## Base URLs

**`Authentication`**

```bash Authentication
https://auth.catenatelematics.com
```

**`API Endpoints`**

```bash API Endpoints
https://api.catenatelematics.com/v2
```

## API Groups

#### [Authentication](/api-reference/authentication-api)

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

#### [Telematics](/api-reference/telematics/telematics-api)

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

#### [Organizations](/api-reference/orgs/organizations-api)

Manage fleet invitations, connections, and organizational settings.

#### [Notifications](/api-reference/notifications/notifications-api)

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

#### [Integrations](/api-reference/integrations/integrations-api)

Monitor and manage telematics provider connections and data sync status.

## Quick Start

#### Get API Credentials

Contact our team to receive your Client ID and Secret. See [Getting Access](/get-started/getting-access).

#### Authenticate

Exchange your credentials for an access token using the [Get Token](/api-reference/authentication-api) endpoint.

#### 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:

```bash
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

> **Info**
>
> Rate limits are enforced per organization. Contact [support@catenaclearing.io](mailto: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:

```json
{
  "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

#### Consistent Results

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

#### Better Performance

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

#### No Duplicate or Missing Records

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-started/quickstart)

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

#### [API Reference](/api-reference)

Explore all available endpoints, parameters, and response formats.

#### [Get API Credentials](/get-started/getting-access)

Request access to start building with the Catena Telematics API.

#### [Supported Providers](/get-started/supported-providers)

Browse the telematics providers available through our platform.