Quickstart

1. Create an API client

In your dashboard, go to Settings → Developers → API clients and create a client. Choose the scopes it needs — for example consignments:read consignments:write classify:read calculate:read. You’ll get a client ID and client secret. The secret is shown once — store it somewhere safe.

2. Get an access token

API clients are machine-to-machine (M2M) OAuth clients. Exchange your credentials for a short-lived bearer token:

curl -X POST https://{partner}.mytraddal.com/admin/oauth2/token \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'grant_type=client_credentials' \
  -d 'client_id={client_id}' \
  -d 'client_secret={client_secret}'

The response contains access_token and expires_in. Tokens are JWTs bound to your workspace’s organization — a token minted for one partner can never read another partner’s data.

3. Make your first call

curl https://{partner}.mytraddal.com/admin/api/v1/consignments \
  -H 'Authorization: Bearer {access_token}'

{
  "consignments": [],
  "total": 0
}

4. Classify a product

The classify and calculate endpoints live on the same Admin API, so the same token works (with the classify:read / calculate:read scopes):

curl -X POST https://{partner}.mytraddal.com/admin/api/v1/classify \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {access_token}' \
  -d '{
    "description": "Men'\''s waterproof hiking backpack, 40L, nylon",
    "destination_country": "US"
  }'

Next steps

Authentication

Scopes, token lifetimes, and how partner isolation is enforced.

API conventions

snake_case on the wire, versioning, and error shapes.

Traddal developer documentation

Partner domains

⌘I

Getting started

Concepts

1. Create an API client

2. Get an access token

3. Make your first call

4. Classify a product

Next steps

Authentication

API conventions

​1. Create an API client

​2. Get an access token

​3. Make your first call

​4. Classify a product

​Next steps

Authentication

API conventions

1. Create an API client

2. Get an access token

3. Make your first call

4. Classify a product

Next steps