Altexpress Platform API | OpenAPI spec: /api-docs/openapi.json | Import into Postman: Import → Link → paste the URL above
Quick start & AWB import / tracking guide

1 · Authenticate

  1. Click Authorize (top right) and paste your JWT token.
  2. Every request sends it as the X-Authorization header.
  3. Tokens are issued per environment — contact Altexpress support.

2 · Create & ship an order

  1. POST /orders — creates the order and reserves stock.
  2. Let Altexpress generate the AWB (generate_awb: true) or import your own (step 3).

3 · Import your own AWB

  1. POST /v2/awb/import — links your AWB, deducts stock, makes a PDF label.
  2. Any courier_slug works; unknown ones auto-create a virtual courier.
  3. No stock available? The order moves to On Hold (20) automatically.

4 · Keep tracking in sync

  1. POST /v2/awb/status-update — push your platform status (e.g. delivered); it maps automatically.
  2. GET /v2/awb/status-map — see the full external⇆Altexpress mapping table.
  3. Status 12 (Return Complete) restores stock to the warehouse (idempotent).

Each endpoint below has ready-to-run Examples in its request body dropdown — pick one, hit Try it out → Execute. See the full overview in the description at the top of the spec.