# Hauler Hero API Platform

![Hauler Hero Logo](/assets/business_logo.e03a2f7bae7265b07e51cf82d92ab93baf1cb204fbf074b38849dfd2098ed8c8.c5aff763.png)

Welcome to the Hauler Hero API documentation. Our platform provides APIs for waste management and logistics operations. These fall into two categories (inbound versus outbound), depending on who implements the endpoint and who calls it.

> **Terminology**
**Haulers** — Hauler Hero's customers; waste management companies running their operations on our platform.
**Partners** — Third-party software or hardware vendors (e.g., scale systems, vision/camera providers) that integrate with Hauler Hero on behalf of mutual customers (haulers).


## Getting Started

1. Identify which APIs apply to your integration.
2. For **Inbound APIs**: request credentials from your Hauler Hero account manager.
3. For **Outbound APIs**: review the API's Integration Guide, build the endpoint on your infrastructure, then share your URL and `API-KEY` with Hauler Hero.
4. Read each API's Integration Guide for field requirements, workflows, and examples.


## Available APIs

| API | Direction | Purpose |
|  --- | --- | --- |
| **Account API** | Inbound | Customer accounts and billing |
| **Scale API** | Inbound | Weight tickets and material tracking |
| **Site API** | Outbound | Sites, kiosks, and materials synchronization |
| **Vision API** | Outbound | On-demand and continuous truck-camera video |


## Inbound APIs

*You call Hauler Hero.*

Partners call these APIs hosted by Hauler Hero.

- **Account API** — customer accounts and billing
- **Scale API** — weight tickets and material tracking


**Base URL:**


```
https://api.haulerhero.com
```

**Authentication:** include the `HERO-API-KEY` header on every request. Keys are issued by Hauler Hero — contact [integrations@haulerhero.com](mailto:integrations@haulerhero.com).

## Outbound APIs

*Partner-hosted — Hauler Hero calls you.*

These APIs are contracts for integration partners to implement on their own infrastructure.

- **Site API** — sites, kiosks, and materials synchronization
- **Vision API** — on-demand and continuous truck-camera video


**How it works:** partners build the endpoint on their own server, issue an `API-KEY` to Hauler Hero, and Hauler Hero sends that key in the `API-KEY` header when calling the partner's endpoints.

See [Authentication](/authentication) for full details.

## Support

- Integration questions: [integrations@haulerhero.com](mailto:integrations@haulerhero.com)
- API support: [api-support@haulerhero.com](mailto:api-support@haulerhero.com)