curl --request POST \
--url 'https://prod-api.stateset.cloud.stateset.app/api/v1/purchase-orders' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"currency": "USD",
"expected_delivery_date": "2026-08-31T14:22:05Z",
"items": [
{
"currency": "USD",
"description": "Two-person tent, green — replacement for damaged pole set.",
"product_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"quantity": 2,
"tax_rate": 7.5,
"unit_price": 49
}
],
"notes": "Two-person tent, green — replacement for damaged pole set.",
"payment_terms": "string",
"shipping_address": {
"city": "San Francisco",
"country": "US",
"postal_code": "94107",
"state": "CA",
"street": "548 Market St"
},
"supplier_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}'
{
"data": null,
"errors": [
"string"
],
"message": "Two-person tent, green — replacement for damaged pole set.",
"meta": {
"request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"timestamp": "2026-08-31T14:22:05Z"
},
"success": true
}
Create a new purchase order
Purchase order created
POST
/
api
/
v1
/
purchase-orders
curl --request POST \
--url 'https://prod-api.stateset.cloud.stateset.app/api/v1/purchase-orders' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"currency": "USD",
"expected_delivery_date": "2026-08-31T14:22:05Z",
"items": [
{
"currency": "USD",
"description": "Two-person tent, green — replacement for damaged pole set.",
"product_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"quantity": 2,
"tax_rate": 7.5,
"unit_price": 49
}
],
"notes": "Two-person tent, green — replacement for damaged pole set.",
"payment_terms": "string",
"shipping_address": {
"city": "San Francisco",
"country": "US",
"postal_code": "94107",
"state": "CA",
"street": "548 Market St"
},
"supplier_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}'
{
"data": null,
"errors": [
"string"
],
"message": "Two-person tent, green — replacement for damaged pole set.",
"meta": {
"request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"timestamp": "2026-08-31T14:22:05Z"
},
"success": true
}
Request body
CreatePurchaseOrderRequest
string,null
string
required
PurchaseOrderItemRequest[]
required
string,null
string,null
ShippingAddressRequest
required
string (uuid)
required
Response
ApiResponse_Value
any
array,null
string,null
boolean
required
Status codes
| Code | Meaning |
|---|---|
201 | Purchase order created |
400 | Invalid request |
curl --request POST \
--url 'https://prod-api.stateset.cloud.stateset.app/api/v1/purchase-orders' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"currency": "USD",
"expected_delivery_date": "2026-08-31T14:22:05Z",
"items": [
{
"currency": "USD",
"description": "Two-person tent, green — replacement for damaged pole set.",
"product_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"quantity": 2,
"tax_rate": 7.5,
"unit_price": 49
}
],
"notes": "Two-person tent, green — replacement for damaged pole set.",
"payment_terms": "string",
"shipping_address": {
"city": "San Francisco",
"country": "US",
"postal_code": "94107",
"state": "CA",
"street": "548 Market St"
},
"supplier_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}'
{
"data": null,
"errors": [
"string"
],
"message": "Two-person tent, green — replacement for damaged pole set.",
"meta": {
"request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"timestamp": "2026-08-31T14:22:05Z"
},
"success": true
}
Last modified on August 31, 2026