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

# Build with Hellotracks

> Three ways to connect to Hellotracks: the JSON API, the REST API and the ht command line.

Hellotracks has three ways in. They reach the same company data: jobs, routes, people, places, timesheets, forms and reports. Pick the one that fits how you work. All three use the same API key, from **More → API & Integrations** in the [dashboard](https://live.hellotracks.com).

> [card] [JSON API](https://api-docs.hellotracks.com/api-reference/overview.md)
>
> Build an integration in code, with one JSON request per action.

> [card] [REST API](https://api-docs.hellotracks.com/v1/overview.md)
>
> Build tools and automations on plain REST resources.

> [card] [CLI](https://api-docs.hellotracks.com/cli/overview.md)
>
> Work from a terminal or let an AI agent run things. One install line.

## The same task three ways

List today's jobs for every worker.

```bash JSON API theme={null}
curl -X POST https://api.hellotracks.com/api/getjobs \
  --header 'API-Key: YOUR_KEY_ID.YOUR_SECRET' \
  --header 'Content-Type: application/json' \
  -d '{ "data": { "worker": "*" } }'
```

```bash REST API theme={null}
curl "https://api.hellotracks.com/v1/jobs?date=2026-11-02" \
  --header 'API-Key: YOUR_KEY_ID.YOUR_SECRET'
```

```bash CLI theme={null}
ht jobs list --date today
```

## Which one fits

| | Good for | Looks like |
| - | - | - |
| **JSON API** | Integrations written by developers | `POST /api/getjobs` with a JSON body |
| **REST API** | Tools, automations and services over HTTP | `GET /v1/jobs` |
| **CLI** | Terminals, scripts, CI and AI agents | `ht jobs list` |

Each has things the others don't yet: the JSON API has dispatch, live locations and GPS tracks; the REST API and the CLI have timesheets, forms, alerts, ETA pages and maps; the CLI adds bulk import, sync and export.

> [!NOTE]
>
> **AI agents:** read [For AI agents](https://api-docs.hellotracks.com/agents.md). In short: use the CLI. If you can only make HTTP requests, use the REST API.

## Help

Questions about any of the three: [api@hellotracks.com](mailto:api@hellotracks.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.