API Reference
The Orderly Hub API is a REST API built on Hono. All endpoints are under the /api prefix and require authentication.
Base URL: https://api.orderly.dev
Authentication
How to authenticate with the API using session tokens or API keys.
Errors
Error response format and common error codes.
Pagination
How list endpoints paginate results.
Endpoint Groups
| Group | Base Path | Scopes |
|---|---|---|
| Orders | /api/orders | orders:read, orders:write |
| Shipments | /api/shipments | shipments:read, shipments:write |
| Bridges | /api/bridges | bridges:read, bridges:write |
| Bridge Types | /api/bridge-types | bridges:read |
| Operations | /api/operations | operations:read, operations:write, operations:execute |
| Dispatchers | /api/dispatchers | dispatchers:read, dispatchers:write |
| Condition Sets | /api/condition-sets | dispatchers:read, dispatchers:write |
| Transformations | /api/transformations | transformations:read, transformations:write |
| Carrier Accounts | /api/carrier-accounts | carrier-accounts:read, carrier-accounts:write |
| Rates | /api/rates | rates:read |
| Pickups | /api/pickups | pickups:read, pickups:write |
| Schedules | /api/schedules | bridges:read, bridges:write |
| Split Rules | /api/split-rules | orders:read, orders:write |
| API Keys | /api/api-keys | Admin only |
| Organizations | /api/organizations | Varies |
| Webhooks | /api/webhooks | webhooks:manage |
| Agent | /api/agent | agent:read, agent:write |
| Embed | /api/embed | embed:manage |
| Insights | /api/insights | insights:read |
| Tracking | /api/shipment-tracking | shipments:read |