> For the complete documentation index, see [llms.txt](https://routelift.gitbook.io/routelift-api-integration/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://routelift.gitbook.io/routelift-api-integration/getting-started/quickstart.md).

# Overview

RouteLift offers a secure and reliable API for partners to:

* Authenticate using API Keys
* Create and manage deliveries
* Track delivery status
* Estimate delivery pricing
* Receive status updates via webhooks

All business logic and operations are handled behind the scenes. API clients interact solely with the Integrations App.

***

### Authentication

#### API Key

* Partners generate API keys via the Partner Dashboard.
* API keys are used to authenticate external API calls.
* Keys are validated at the API gateway before any processing.

#### Auth Flow

```
[Partner System] → [RouteLift API]
    (API Key)         (Verify Key & Process Request)
```

***

### API Design Principles

* RESTful endpoints
* JSON request and response formats
* Standard HTTP status codes
* Stateless requests

***

### Core Features

#### Deliveries

* Support for multi-pickup to single-drop deliveries
* Track, cancel, and get delivery status
* Estimate delivery pricing

#### Webhooks

* Partners can register webhook URLs
* RouteLift sends real-time status updates

#### Rate Limiting

* Defined per API key
* Example: 1000 requests per hour
* Exceeding the limit returns HTTP 429