Create Purchase Order

This endpoint creates a new purchase order

POST /v1/purchase_orders

cURL

curl -X POST https://api.stateset.com/v1/purchaseorders \
  -H "Authorization: Bearer ${STATESET_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "purchase_order_number": "PO-2026-001234",
    "description": "Q1 inventory restock — blue t-shirts",
    "vendor": "Acme Textiles Inc.",
    "total": "4500.00",
    "subtotal": "4200.00",
    "purchase_date": "2026-01-15T00:00:00.000Z",
    "delivery_date": "2026-02-01T00:00:00.000Z"
  }'

Response

{
    "id": "po_1a2b3c4d5e6f",
    "createdat": "2026-01-15T12:00:00.000Z",
    "delivery_date": "2026-02-01T00:00:00.000Z",
    "description": "Q1 inventory restock — blue t-shirts",
    "external_id": "ext_po_98765",
    "financer": "fin_abc123",
    "fulfiller": "ful_def456",
    "lastupdated": "2026-01-15T12:00:00.000Z",
    "purchase_date": "2026-01-15T00:00:00.000Z",
    "purchase_order_hash": "a1b2c3d4e5f6",
    "purchase_order_name": "Q1 Blue T-Shirt Restock",
    "purchase_order_number": "PO-2026-001234",
    "purchase_order_status": "created",
    "purchaser": "usr_abc123",
    "subtotal": "4200.00",
    "total": "4500.00",
    "vendor": "Acme Textiles Inc.",
    "transaction_id": "txn_789xyz"
}

Body

id · string

This is the id of the purchase order.

createdat · string

This is the date the purchase order was created.

delivery_date · string

This is the date the purchase order was delivered.

description · string

This is the description of the purchase order.

external_id · string

This is the external id of the purchase order.

financer · string

This is the financer of the purchase order.

fulfiller · string

This is the fulfiller of the purchase order.

lastupdated · string

This is the date the purchase order was last updated.

purchase_date · string

This is the date the purchase order was purchased.

purchase_order_hash · string

This is the hash of the purchase order.

purchase_order_name · string

This is the name of the purchase order.

purchase_order_number · string

This is the number of the purchase order.

purchase_order_status · string

This is the status of the purchase order.

purchaser · string

This is the purchaser of the purchase order.

subtotal · string

This is the subtotal of the purchase order.

total · string

This is the total of the purchase order.

vendor · string

This is the vendor of the purchase order.

transaction_id · string

This is the transaction id of the purchase order.

Response

id · string

This is the id of the purchase order.

createdat · string

This is the date the purchase order was created.

delivery_date · string

This is the date the purchase order was delivered.

description · string

This is the description of the purchase order.

external_id · string

This is the external id of the purchase order.

financer · string

This is the financer of the purchase order.

fulfiller · string

This is the fulfiller of the purchase order.

lastupdated · string

This is the date the purchase order was last updated.

purchase_date · string

This is the date the purchase order was purchased.

purchase_order_hash · string

This is the hash of the purchase order.

purchase_order_name · string

This is the name of the purchase order.

purchase_order_number · string

This is the number of the purchase order.

purchase_order_status · string

This is the status of the purchase order.

purchaser · string

This is the purchaser of the purchase order.

subtotal · string

This is the subtotal of the purchase order.

total · string

This is the total of the purchase order.

vendor · string

This is the vendor of the purchase order.

transaction_id · string

This is the transaction id of the purchase order.

cURL

curl -X POST https://api.stateset.com/v1/purchaseorders \
  -H "Authorization: Bearer ${STATESET_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "purchase_order_number": "PO-2026-001234",
    "description": "Q1 inventory restock — blue t-shirts",
    "vendor": "Acme Textiles Inc.",
    "total": "4500.00",
    "subtotal": "4200.00",
    "purchase_date": "2026-01-15T00:00:00.000Z",
    "delivery_date": "2026-02-01T00:00:00.000Z"
  }'

Response

{
    "id": "po_1a2b3c4d5e6f",
    "createdat": "2026-01-15T12:00:00.000Z",
    "delivery_date": "2026-02-01T00:00:00.000Z",
    "description": "Q1 inventory restock — blue t-shirts",
    "external_id": "ext_po_98765",
    "financer": "fin_abc123",
    "fulfiller": "ful_def456",
    "lastupdated": "2026-01-15T12:00:00.000Z",
    "purchase_date": "2026-01-15T00:00:00.000Z",
    "purchase_order_hash": "a1b2c3d4e5f6",
    "purchase_order_name": "Q1 Blue T-Shirt Restock",
    "purchase_order_number": "PO-2026-001234",
    "purchase_order_status": "created",
    "purchaser": "usr_abc123",
    "subtotal": "4200.00",
    "total": "4500.00",
    "vendor": "Acme Textiles Inc.",
    "transaction_id": "txn_789xyz"
}