Purchase Orders

Get purchase orders

Use the following endpoints to retrieve all or filtered purchase orders.

Note: If your purchase order is created from an integrated supplier then you will get an integrated_supplier_id instead of a supplier_id in the response payload. The integrated_supplier_id actually maps to another Site rather than a Supplier.

GET /v1/companies/1234/purchase_orders Get all purchase orders for a company
GET /v1/companies/1234/purchase_orders/received Get all received purchase orders
GET /v1/companies/1234/purchase_orders/placed Get all placed purchase orders
GET /v1/companies/1234/sites/456/purchase_orders Get all purchase orders for a site
GET /v1/companies/1234/suppliers/789/purchase_orders Get all purchase orders for a supplier
GET /v1/companies/1234/purchase_orders ?created_gte=2017-04-05T10:00:00 Get all purchase orders created on or after a given time
GET /v1/companies/1234/purchase_orders ?created_lte=2017-04-05T10:00:00 Get all purchase orders created on or before a given time
GET /v1/companies/1234/purchase_orders ?received_gte=2017-04-05T10:00:00 Get all purchase orders received on or after a given time
GET /v1/companies/1234/purchase_orders ?received_lte=2017-04-05T10:00:00 Get all purchase orders received on or before a given time
  • When filtering purchase orders by created_gte, created_lte, placed_lte, placed_gte, received_lte or received_gte the date must be in ISO 8601 format.
  • Any combination of created_gte, created_lte, placed_lte, placed_gte, received_lte and received_gte are accepted.

Get a purchase order

Note: If your purchase order is created from an integrated supplier then you will get an integrated_supplier_id instead of a supplier_id in the supplier object. The integrated_supplier_id actually maps to another Site rather than a Supplier.

GET /v1/companies/123/sites/456/purchase_orders/78 Get a purchase order by ID

List of Webhooks

Here is a list of the supported webhook topics.

purchase_orders/cancelled

When a purchase order is marked as cancelled. You will receive the complete purchase order.

purchase_orders/deleted

When a purchase order is deleted. You will receive the complete purchase order. Note that you will receive the last state of the purchase order with "deleted": true.

purchase_orders/delivered

When a purchase order is marked as delivered. You will receive the complete purchase order.

purchase_orders/draft

When a purchase order is created as a draft. You will receive the complete purchase order.

purchase_orders/placed

When a purchase order is marked as placed. You will receive the complete purchase order.

purchase_orders/received

When a purchase order is marked as received. You will receive the complete purchase order.