> ## Documentation Index
> Fetch the complete documentation index at: https://docs.catenatelematics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

> Complete reference documentation for the Catena Telematics API

export const ProviderCountSnippet = () => <Callout icon="layer-group" color="#3b82f6" iconType="duotone">
    <p>
      Catena currently supports <strong>216 ELD providers</strong>. <a href="/get-started/supported-providers">See the list</a>.
    </p>
  </Callout>;

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

<ProviderCountSnippet />

## Base URLs

<CodeGroup>
  ```bash Authentication theme={null}
  https://auth.catenatelematics.com
  ```

  ```bash API Endpoints theme={null}
  https://api.catenatelematics.com/v2
  ```
</CodeGroup>

## API Groups

<CardGroup cols={2}>
  <Card icon="key" title="Authentication" href="/api-reference/authentication-api">
    Obtain and manage access tokens using OAuth 2.0 client credentials flow.
  </Card>

  <Card icon="truck" title="Telematics" href="/api-reference/telematics-api">
    Access vehicle locations, driver data, HOS records, fuel transactions, and IFTA reports.
  </Card>

  <Card icon="building" title="Organizations" href="/api-reference/organizations-api">
    Manage fleet invitations, connections, and organizational settings.
  </Card>

  <Card icon="bell" title="Notifications" href="/api-reference/notifications-api">
    Configure webhooks to receive real-time updates for fleet events.
  </Card>

  <Card icon="plug" title="Integrations" href="/api-reference/integrations-api">
    Monitor and manage telematics provider connections and data sync status.
  </Card>
</CardGroup>

## Quick Start

<Steps>
  <Step title="Get API Credentials">
    Contact our team to receive your Client ID and Secret. See [Getting Access](/get-started/getting-access).
  </Step>

  <Step title="Authenticate">
    Exchange your credentials for an access token using the [Get Token](/api-reference/authentication-api) endpoint.
  </Step>

  <Step title="Make API Calls">
    Use your access token in the `Authorization: Bearer <token>` header for all API requests.
  </Step>
</Steps>

## Authentication

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

```bash theme={null}
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.
</Info>

## 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 theme={null}
{
  "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

<AccordionGroup>
  <Accordion title="Consistent Results">
    Cursors maintain stable references to specific positions in the dataset, even when new records are added or removed during pagination.
  </Accordion>

  <Accordion title="Better Performance">
    Cursor-based queries are more efficient for large datasets, avoiding the performance degradation common with high-offset pagination.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

***

# Ready to Get Started?

<CardGroup cols={2}>
  <Card icon="rocket" title="Quick Start Guide" href="/get-started/quickstart">
    Get up and running in 10 minutes with our step-by-step integration tutorial.
  </Card>

  <Card icon="book-open" title="API Reference" href="/api-reference">
    Explore all available endpoints, parameters, and response formats.
  </Card>

  <Card icon="user-plus" title="Get API Credentials" href="/get-started/getting-access">
    Request access to start building with the Catena Telematics API.
  </Card>

  <Card icon="plug" title="Supported Providers" href="/get-started/supported-providers">
    Browse the telematics providers available through our platform.
  </Card>
</CardGroup>