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

# Introduction

> Welcome to the Shipdesk Public API documentation. Unify your Indian logistics across Delhivery, Shadowfax, Xpressbees, and Ekart with a single consistent API.

# Welcome to Shipdesk API

Shipdesk provides a modern, unified shipping infrastructure for high-growth e-commerce brands in India. With a single REST API, merchants can rate-shop, assign carriers, generate official courier AWBs and barcode shipping labels, automate Non-Delivery Report (NDR) workflows, and ingest tracking webhooks.

> [card] [Quickstart Guide](https://docs.apps.lute.co.in/quickstart.md)
>
> Book your first shipment and generate an AWB in under 5 minutes.

> [card] [Standardised JSON Schema](https://docs.apps.lute.co.in/standards/response-schema.md)
>
> Learn about our strict JSON envelope, error format, and courier abstraction guarantees.

> [card] [API Keys & Auth](https://docs.apps.lute.co.in/authentication.md)
>
> Generate Bearer API keys from your dashboard settings.

> [card] [Webhooks](https://docs.apps.lute.co.in/webhooks/overview.md)
>
> Subscribe to real-time order lifecycle, scan updates, and delivery events.

## Core Principles

> [accordion] 1. Courier-First Safety
>
> Anything that modifies real-world logistics (assigning an AWB, cancelling an order, scheduling a pickup, or submitting an NDR re-attempt) calls the underlying courier partner first. Only when the carrier API confirms acceptance does Shipdesk commit the change locally. A carrier refusal leaves your data safe and untouched.

> [accordion] 2. Zero Courier Leaks (Unified Schema)
>
> Every public API endpoint returns clean, normalized Shipdesk JSON. We never expose raw courier JSON responses, vendor-specific status codes, internal database IDs, or carrier tokens to your frontend or API clients.

> [accordion] 3. Multi-Carrier Intelligence
>
> Our availability engine verifies parcel dimensions, weight, PIN code serviceability, payment modes (Prepaid vs COD), and lane quotes in real time across Delhivery, Shadowfax, Xpressbees, and Ekart to offer valid carriers only.

## API Interface & Environments

The public API is hosted over TLS at:

```http theme={null}
https://api.apps.lute.co.in/v1
```

All requests must include your API key in the `Authorization` header:

```bash theme={null}
curl https://api.apps.lute.co.in/v1/orders \
  -H "Authorization: Bearer sd_live_your_api_key_here" \
  -H "Content-Type: application/json"
```


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