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

# Traddal developer documentation

> Build cross-border commerce tools on Traddal — duty calculation, HS classification, consignments, manifests, and webhooks.

Traddal is a multi-partner customs and cross-border logistics platform. Every
partner gets its own subdomain — `{partner}.mytraddal.com` — and its own
versioned Admin API covering consignments, classification, duty calculation,
manifests, and webhooks.

```bash theme={null}
curl -X POST \
  https://{partner}.mytraddal.com/admin/api/v1/consignments \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {access_token}' \
  -d '{
    "shipment_ref": "SHIP-1001",
    "receiver": { "country_code": "US", "city": "New York" }
  }'
```

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/guides/quickstart">
    Mint an API client, get a token, and make your first call in five minutes.
  </Card>

  <Card title="Partner domains" icon="globe" href="/guides/partner-domains">
    How `{partner}.mytraddal.com` subdomains work and why the subdomain is the
    partner boundary.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/overview">
    Every resource on the Admin API — consignments, classify, calculate, and
    more.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/webhooks/overview">
    Signed JSON events for everything that happens to a consignment — no
    polling.
  </Card>
</CardGroup>

## One base URL

Everything lives on your workspace's own domain:

```text theme={null}
https://{partner}.mytraddal.com/admin/api/v1/{resource}
```

The Admin API is versioned in the path (`v1`). Breaking changes ship as a
sibling version (`v2`); `v1` stays stable.