Manage customer orders through the Orders API. Create new orders, retrieve existing ones, and update their status.
/api/vendor/ordersReturns the last 100 orders for the vendor, sorted by last update.
curl -s https://brutlers.com/api/vendor/orders \
-H "X-Api-Key: brut_your_api_key_here"Response
{
"orders": [
{
"id": "cm...",
"type": "BRIDAL_DRESS",
"status": "ORDERED",
"model": "Valentina A-Line",
"size": "38",
"color": "Ivory",
"description": "Custom bridal dress",
"specialRequests": "Extra lace on sleeves",
"customer": {
"name": "Anna Müller",
"email": "anna@example.com"
},
"updates": [
{
"status": "ORDERED",
"message": "Order created via API",
"createdAt": "2026-03-10T14:30:00.000Z"
}
],
"createdAt": "2026-03-10T14:30:00.000Z",
"updatedAt": "2026-03-10T14:30:00.000Z"
}
]
}/api/vendor/ordersCreates a new customer order. If a customer with the same email already exists, they will be linked automatically.
Request Body
| Field | Type | Description | |
|---|---|---|---|
| customerName | string | Required | Customer name |
| type | enum | Required | Order type: BRIDAL_DRESS, SUIT, RENTAL |
| customerEmail | string | Optional | Customer email address |
| customerPhone | string | Optional | Customer phone number |
| weddingDate | string | Optional | Wedding date (ISO 8601) |
| model | string | Optional | Model name |
| description | string | Optional | Order description |
| size | string | Optional | Size |
| color | string | Optional | Color |
| specialRequests | string | Optional | Special requests |
curl -X POST https://brutlers.com/api/vendor/orders \
-H "X-Api-Key: brut_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"customerName": "Anna Müller",
"customerEmail": "anna@example.com",
"type": "BRIDAL_DRESS",
"model": "Valentina A-Line",
"size": "38",
"color": "Ivory"
}'Response (201)
{ "id": "cm...", "status": "ORDERED" }/api/vendor/orders/{id}/statusUpdates the status of an existing order. An optional message and image can be attached.
Request Body
| Field | Type | Description | |
|---|---|---|---|
| status | enum | Required | New status |
| message | string | Optional | Status message for the customer |
| imageUrl | string | Optional | URL to an image (e.g. progress photo) |
curl -X PUT https://brutlers.com/api/vendor/orders/ORDER_ID/status \
-H "X-Api-Key: brut_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"status": "IN_PRODUCTION",
"message": "Fabric has been cut, starting assembly."
}'Response
{ "id": "cm...", "status": "IN_PRODUCTION" }