API v2
The Basalt delivery & events API
One REST surface for dispatch, tracking and webhooks. Predictable resources, cursor pagination, and idempotent writes.
All systems operational
— API, webhooks and dashboard. Updated just now.
History
99.98%30-day uptime
112 msp50 latency
v2.7current release
Quickstart
Authenticate with a bearer token, then call the API base URL.
curl https://api-v2-099a4d10.alienbot.online/v2/shipments \
-H "Authorization: Bearer $BASALT_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "destination": "AMS", "weight_g": 1200 }'Responses are JSON. Rate limit: 600 requests/minute per token.
Endpoint reference
| Method | Path | Description |
|---|---|---|
| GET | /v2/shipments | List shipments (cursor paginated) |
| POST | /v2/shipments | Create a shipment |
| GET | /v2/shipments/{id} | Retrieve a shipment |
| POST | /v2/webhooks | Register a webhook endpoint |
| GET | /v2/events | Stream delivery events |