Orders API overview
Create, manage and track Marketplace orders from checkout through fulfillment.
Authentication
OAuth 2.0
Permissions
marketplace:write
Rate limit
120 requests / min
Response
200 OK
Overview
Create, manage and track Marketplace orders from checkout through fulfillment.
Key capabilities
Unified ordering
Create marketplace orders.
Tracking
Follow fulfillment status.
Secure
Tenant- and role-scoped access.
Events
React to order changes.
Available endpoints
| Method | Endpoint | Purpose |
|---|---|---|
POST | /orders | Create order |
GET | /orders | List orders |
GET | /orders/{id} | Get order |
POST | /orders/{id}/cancel | Cancel order |
Workflow
01
Created
02
Paid
03
Processing
04
Fulfilled
Authentication
Use OAuth 2.0 credentials and the least-privilege Marketplace scopes required by your application.
Common use cases
| Scenario | Recommendation |
|---|---|
Interactive applications | Use scoped user/organization access |
Back-office sync | Use server-side credentials and idempotency |
High-volume jobs | Use pagination and respect rate limits |