List Orders
GET /api/v1/orders
Returns a paginated list of orders for the authenticated user with optional filtering.
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
per_page | integer | 15 | Number of items per page (max: 100) |
page | integer | 1 | Page number |
fulfillment_status | string | — | Filter by fulfillment status: pending, processing, partially_fulfilled, completed, refunded, partially_refunded, cancelled |
payment_status | string | — | Filter by payment status: pending, completed |
start_date | date | — | Only orders created on or after this date, e.g. 2026-10-01 (UTC, inclusive) |
end_date | date | — | Only orders created on or before this date, e.g. 2026-10-31 (UTC, inclusive) |
sort | string | desc | asc for oldest first, desc for newest first |
To pull every order in a period, use
start_date, end_date and sort=asc, then follow links.next until it is null. With sort=asc new orders only ever land on the last page, so earlier pages don’t shift while you are paging.curl "https://api.manastore.com/api/v1/orders?start_date=2026-10-01&end_date=2026-10-31&sort=asc&per_page=100" \
-H "Authorization: Bearer your-token-here" \
-H "Accept: application/json"
Responses
| Status | Description |
|---|---|
200 OK | Successful operation |
401 Unauthorized | Missing or invalid authentication token |
403 Forbidden | Access denied |
422 Unprocessable Entity | Invalid filter, e.g. end_date before start_date |
Example Response
{
"data": [
{
"id": 12345,
"ulid": "01J9Z3NDEKTSV4RRFFQ69G5FAV",
"order_number": "#12345",
"transaction_id": "01J9Z3NDF0RXKQ5V3Q8M2B7C1D",
"fulfillment_status": "completed",
"payment_status": "completed",
"subtotal": {
"amount": "4426",
"currency": "USD",
"formatted": "$44.26",
"decimal": "44.26",
"localized_decimal": "44.26"
},
"conversion_fees": {
"amount": "0",
"currency": "USD",
"formatted": "$0.00",
"decimal": "0.00",
"localized_decimal": "0.00"
},
"total": {
"amount": "4426",
"currency": "USD",
"formatted": "$44.26",
"decimal": "44.26",
"localized_decimal": "44.26"
},
"currency": "USD",
"items": [
{
"id": 67890,
"quantity": 2,
"variant_name": "PlayStation Network Card $25 USA",
"product_name": "PlayStation Network Card $25 USA",
"unit_price": {
"amount": "2213",
"currency": "USD",
"formatted": "$22.13",
"decimal": "22.13",
"localized_decimal": "22.13"
},
"total_price": {
"amount": "4426",
"currency": "USD",
"formatted": "$44.26",
"decimal": "44.26",
"localized_decimal": "44.26"
},
"product_id": 1042,
"product_variant_id": 1042,
"sku": "1042",
"status": "completed",
"currency": "USD",
"face_value": {
"amount": "2500",
"currency": "USD",
"formatted": "$25.00",
"decimal": "25.00",
"localized_decimal": "25.00"
},
"created_at": "2026-10-01T12:00:00+00:00",
"updated_at": "2026-10-01T12:00:45+00:00"
}
],
"created_at": "2026-10-01T12:00:00+00:00",
"updated_at": "2026-10-01T12:00:45+00:00"
}
],
"links": {
"first": "https://api.manastore.com/api/v1/orders?page=1",
"last": "https://api.manastore.com/api/v1/orders?page=5",
"prev": null,
"next": "https://api.manastore.com/api/v1/orders?page=2"
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 5,
"path": "https://api.manastore.com/api/v1/orders",
"per_page": 15,
"to": 15,
"total": 75
}
}