Purchase Orders

Purchase Orders

post

Body

application/json

supplierstringRequired

shipping_locationstring · nullableOptionalDefault: null

delivery_datestring · date · nullableOptional

In your local timezone.

Default: null

shipping_namestring · nullableOptionalDefault: null

shipping_feenumber · nullableOptionalDefault: null

shipping_fee_taxnumber · nullableOptionalDefault: null

payment_methodstring · nullableOptional

This must be one of the methods available with your supplier, eg Credit Card, Invoice, etc.

Default: null

notesstring · nullableOptionalDefault: null

statusstringOptionalDefault: DRAFT

Responses

201

Created

application/json

idstringOptional

typestring · enumOptionalPossible values:

company_idintegerOptional

order_numberstringOptional

sourcestringOptional

statusstringOptional

created_atstring · datetimeOptional

shipped_atstring · datetime · nullableOptional

paid_atstring · datetime · nullableOptional

received_atstring · datetime · nullableOptional

completed_atstring · datetime · nullableOptional

shipping_location_idstring · nullableOptional

shipping_location_namestring · nullableOptional

delivery_datestring · datetime · nullableOptional

currencystringOptional

amountnumberOptional

amount_notaxnumberOptional

amount_taxnumberOptional

amount_paidnumber · nullableOptional

payment_methodstring · nullableOptional

shipping_namestring · nullableOptional

shipping_feenumber · nullableOptional

shipping_fee_notaxnumber · nullableOptional

shipping_fee_taxnumber · nullableOptional

credit_card_feenumber · nullableOptional

credit_card_fee_notaxnumber · nullableOptional

credit_card_fee_taxnumber · nullableOptional

creditnumber · nullableOptional

credit_notaxnumber · nullableOptional

credit_taxnumber · nullableOptional

notesstringOptional

last_modified_atstring · nullableOptional

post/v1/purchase-orders/

HTTPcURLJavaScriptPython

POST /v1/purchase-orders/ HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 264

{
  "supplier": "text",
  "shipping_location": "text",
  "delivery_date": "2026-07-21",
  "shipping_name": "text",
  "shipping_fee": 1,
  "shipping_fee_tax": 1,
  "payment_method": "text",
  "notes": "text",
  "status": "DRAFT",
  "line_items": [
    {
      "product_id": 1,
      "qty": 1,
      "carton_qty": 1,
      "carton_price": 1
    }
  ]
}

201

Created

{
  "id": "text",
  "type": "Internal",
  "company_id": 1,
  "order_number": "text",
  "source": "text",
  "status": "text",
  "created_at": "text",
  "shipped_at": "text",
  "paid_at": "text",
  "received_at": "text",
  "completed_at": "text",
  "shipping_location_id": "text",
  "shipping_location_name": "text",
  "delivery_date": "text",
  "currency": "text",
  "amount": 1,
  "amount_notax": 1,
  "amount_tax": 1,
  "amount_paid": 1,
  "payment_method": "text",
  "shipping_name": "text",
  "shipping_fee": 1,
  "shipping_fee_notax": 1,
  "shipping_fee_tax": 1,
  "credit_card_fee": 1,
  "credit_card_fee_notax": 1,
  "credit_card_fee_tax": 1,
  "credit": 1,
  "credit_notax": 1,
  "credit_tax": 1,
  "notes": "text",
  "last_modified_at": "text",
  "line_items": [
    {
      "id": 1,
      "order_id": 1,
      "product_id": 1,
      "sku": "text",
      "barcode": "text",
      "name": "text",
      "qty": 1,
      "carton_qty": 1,
      "carton_price": 1,
      "amount": 1,
      "amount_notax": 1,
      "amount_tax": 1
    }
  ],
  "supplier": {
    "id": "text",
    "type": "Internal",
    "name": "text",
    "abn": "text",
    "email": "text",
    "phone": "text",
    "account_number": "text",
    "website": "text",
    "payment_terms": 1,
    "payment_terms_period": "text",
    "currency": "text",
    "notes": "text",
    "last_modified_at": "text",
    "contacts": [
      {
        "first_name": "text",
        "last_name": "text",
        "email": "text",
        "phone": "text",
        "mobile_area": "text",
        "mobile_number": "text",
        "role": "text"
      }
    ],
    "locations": [
      {
        "id": "text",
        "name": "text",
        "is_billing": true,
        "is_shipping": true,
        "manage_stock": true,
        "address": "text",
        "suburb": "text",
        "state": "text",
        "postcode": "text",
        "country": "text",
        "location": {},
        "opening_hours": {}
      }
    ],
    "groups": [
      {
        "id": 1,
        "name": "text"
      }
    ]
  }
}

get

Query parameters

idstringRequired

Responses

200

OK

application/json

idstringOptional

typestring · enumOptionalPossible values:

company_idintegerOptional

order_numberstringOptional

sourcestringOptional

statusstringOptional

created_atstring · datetimeOptional

shipped_atstring · datetime · nullableOptional

paid_atstring · datetime · nullableOptional

received_atstring · datetime · nullableOptional

completed_atstring · datetime · nullableOptional

shipping_location_idstring · nullableOptional

shipping_location_namestring · nullableOptional

delivery_datestring · datetime · nullableOptional

currencystringOptional

amountnumberOptional

amount_notaxnumberOptional

amount_taxnumberOptional

amount_paidnumber · nullableOptional

payment_methodstring · nullableOptional

shipping_namestring · nullableOptional

shipping_feenumber · nullableOptional

shipping_fee_notaxnumber · nullableOptional

shipping_fee_taxnumber · nullableOptional

credit_card_feenumber · nullableOptional

credit_card_fee_notaxnumber · nullableOptional

credit_card_fee_taxnumber · nullableOptional

creditnumber · nullableOptional

credit_notaxnumber · nullableOptional

credit_taxnumber · nullableOptional

notesstringOptional

last_modified_atstring · nullableOptional

get/v1/purchase-orders/get

HTTPcURLJavaScriptPython

GET /v1/purchase-orders/get?id=text HTTP/1.1
Accept: */*

200

OK

{
  "id": "text",
  "type": "Internal",
  "company_id": 1,
  "order_number": "text",
  "source": "text",
  "status": "text",
  "created_at": "text",
  "shipped_at": "text",
  "paid_at": "text",
  "received_at": "text",
  "completed_at": "text",
  "shipping_location_id": "text",
  "shipping_location_name": "text",
  "delivery_date": "text",
  "currency": "text",
  "amount": 1,
  "amount_notax": 1,
  "amount_tax": 1,
  "amount_paid": 1,
  "payment_method": "text",
  "shipping_name": "text",
  "shipping_fee": 1,
  "shipping_fee_notax": 1,
  "shipping_fee_tax": 1,
  "credit_card_fee": 1,
  "credit_card_fee_notax": 1,
  "credit_card_fee_tax": 1,
  "credit": 1,
  "credit_notax": 1,
  "credit_tax": 1,
  "notes": "text",
  "last_modified_at": "text",
  "line_items": [
    {
      "id": 1,
      "order_id": 1,
      "product_id": 1,
      "sku": "text",
      "barcode": "text",
      "name": "text",
      "qty": 1,
      "carton_qty": 1,
      "carton_price": 1,
      "amount": 1,
      "amount_notax": 1,
      "amount_tax": 1
    }
  ],
  "supplier": {
    "id": "text",
    "type": "Internal",
    "name": "text",
    "abn": "text",
    "email": "text",
    "phone": "text",
    "account_number": "text",
    "website": "text",
    "payment_terms": 1,
    "payment_terms_period": "text",
    "currency": "text",
    "notes": "text",
    "last_modified_at": "text",
    "contacts": [
      {
        "first_name": "text",
        "last_name": "text",
        "email": "text",
        "phone": "text",
        "mobile_area": "text",
        "mobile_number": "text",
        "role": "text"
      }
    ],
    "locations": [
      {
        "id": "text",
        "name": "text",
        "is_billing": true,
        "is_shipping": true,
        "manage_stock": true,
        "address": "text",
        "suburb": "text",
        "state": "text",
        "postcode": "text",
        "country": "text",
        "location": {},
        "opening_hours": {}
      }
    ],
    "groups": [
      {
        "id": 1,
        "name": "text"
      }
    ]
  }
}

get

Query parameters

pageintegerOptional

Responses

200

OK

application/json

get/v1/purchase-orders/latest

HTTPcURLJavaScriptPython

GET /v1/purchase-orders/latest HTTP/1.1
Accept: */*

200

OK

[
  {
    "id": "text",
    "type": "Internal",
    "company_id": 1,
    "order_number": "text",
    "source": "text",
    "status": "text",
    "created_at": "text",
    "shipped_at": "text",
    "paid_at": "text",
    "received_at": "text",
    "completed_at": "text",
    "shipping_location_id": "text",
    "shipping_location_name": "text",
    "delivery_date": "text",
    "currency": "text",
    "amount": 1,
    "amount_notax": 1,
    "amount_tax": 1,
    "amount_paid": 1,
    "payment_method": "text",
    "shipping_name": "text",
    "shipping_fee": 1,
    "shipping_fee_notax": 1,
    "shipping_fee_tax": 1,
    "credit_card_fee": 1,
    "credit_card_fee_notax": 1,
    "credit_card_fee_tax": 1,
    "credit": 1,
    "credit_notax": 1,
    "credit_tax": 1,
    "notes": "text",
    "last_modified_at": "text",
    "line_items": [
      {
        "id": 1,
        "order_id": 1,
        "product_id": 1,
        "sku": "text",
        "barcode": "text",
        "name": "text",
        "qty": 1,
        "carton_qty": 1,
        "carton_price": 1,
        "amount": 1,
        "amount_notax": 1,
        "amount_tax": 1
      }
    ],
    "supplier": {
      "id": "text",
      "type": "Internal",
      "name": "text",
      "abn": "text",
      "email": "text",
      "phone": "text",
      "account_number": "text",
      "website": "text",
      "payment_terms": 1,
      "payment_terms_period": "text",
      "currency": "text",
      "notes": "text",
      "last_modified_at": "text",
      "contacts": [
        {
          "first_name": "text",
          "last_name": "text",
          "email": "text",
          "phone": "text",
          "mobile_area": "text",
          "mobile_number": "text",
          "role": "text"
        }
      ],
      "locations": [
        {
          "id": "text",
          "name": "text",
          "is_billing": true,
          "is_shipping": true,
          "manage_stock": true,
          "address": "text",
          "suburb": "text",
          "state": "text",
          "postcode": "text",
          "country": "text",
          "location": {},
          "opening_hours": {}
        }
      ],
      "groups": [
        {
          "id": 1,
          "name": "text"
        }
      ]
    }
  }
]

put

Query parameters

idstringRequired

Body

application/json

shipping_locationstring · nullableOptionalDefault: null

delivery_datestring · date · nullableOptional

In your local timezone.

Default: null

shipping_namestring · nullableOptionalDefault: null

shipping_feenumber · nullableOptionalDefault: null

shipping_fee_taxnumber · nullableOptionalDefault: null

payment_methodstring · nullableOptional

This must be one of the methods available with your supplier, eg Credit Card, Invoice, etc.

Default: null

notesstring · nullableOptionalDefault: null

statusstring · nullableOptionalDefault: null

Responses

202

Accepted

application/json

idstringOptional

typestring · enumOptionalPossible values:

company_idintegerOptional

order_numberstringOptional

sourcestringOptional

statusstringOptional

created_atstring · datetimeOptional

shipped_atstring · datetime · nullableOptional

paid_atstring · datetime · nullableOptional

received_atstring · datetime · nullableOptional

completed_atstring · datetime · nullableOptional

shipping_location_idstring · nullableOptional

shipping_location_namestring · nullableOptional

delivery_datestring · datetime · nullableOptional

currencystringOptional

amountnumberOptional

amount_notaxnumberOptional

amount_taxnumberOptional

amount_paidnumber · nullableOptional

payment_methodstring · nullableOptional

shipping_namestring · nullableOptional

shipping_feenumber · nullableOptional

shipping_fee_notaxnumber · nullableOptional

shipping_fee_taxnumber · nullableOptional

credit_card_feenumber · nullableOptional

credit_card_fee_notaxnumber · nullableOptional

credit_card_fee_taxnumber · nullableOptional

creditnumber · nullableOptional

credit_notaxnumber · nullableOptional

credit_taxnumber · nullableOptional

notesstringOptional

last_modified_atstring · nullableOptional

put/v1/purchase-orders/modify

HTTPcURLJavaScriptPython

PUT /v1/purchase-orders/modify?id=text HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 237

{
  "shipping_location": "text",
  "delivery_date": "2026-07-21",
  "shipping_name": "text",
  "shipping_fee": 1,
  "shipping_fee_tax": 1,
  "payment_method": "text",
  "notes": "text",
  "status": "text",
  "line_items": [
    {
      "id": 1,
      "qty": 1,
      "carton_qty": 1,
      "carton_price": 1
    }
  ]
}

202

Accepted

{
  "id": "text",
  "type": "Internal",
  "company_id": 1,
  "order_number": "text",
  "source": "text",
  "status": "text",
  "created_at": "text",
  "shipped_at": "text",
  "paid_at": "text",
  "received_at": "text",
  "completed_at": "text",
  "shipping_location_id": "text",
  "shipping_location_name": "text",
  "delivery_date": "text",
  "currency": "text",
  "amount": 1,
  "amount_notax": 1,
  "amount_tax": 1,
  "amount_paid": 1,
  "payment_method": "text",
  "shipping_name": "text",
  "shipping_fee": 1,
  "shipping_fee_notax": 1,
  "shipping_fee_tax": 1,
  "credit_card_fee": 1,
  "credit_card_fee_notax": 1,
  "credit_card_fee_tax": 1,
  "credit": 1,
  "credit_notax": 1,
  "credit_tax": 1,
  "notes": "text",
  "last_modified_at": "text",
  "line_items": [
    {
      "id": 1,
      "order_id": 1,
      "product_id": 1,
      "sku": "text",
      "barcode": "text",
      "name": "text",
      "qty": 1,
      "carton_qty": 1,
      "carton_price": 1,
      "amount": 1,
      "amount_notax": 1,
      "amount_tax": 1
    }
  ],
  "supplier": {
    "id": "text",
    "type": "Internal",
    "name": "text",
    "abn": "text",
    "email": "text",
    "phone": "text",
    "account_number": "text",
    "website": "text",
    "payment_terms": 1,
    "payment_terms_period": "text",
    "currency": "text",
    "notes": "text",
    "last_modified_at": "text",
    "contacts": [
      {
        "first_name": "text",
        "last_name": "text",
        "email": "text",
        "phone": "text",
        "mobile_area": "text",
        "mobile_number": "text",
        "role": "text"
      }
    ],
    "locations": [
      {
        "id": "text",
        "name": "text",
        "is_billing": true,
        "is_shipping": true,
        "manage_stock": true,
        "address": "text",
        "suburb": "text",
        "state": "text",
        "postcode": "text",
        "country": "text",
        "location": {},
        "opening_hours": {}
      }
    ],
    "groups": [
      {
        "id": 1,
        "name": "text"
      }
    ]
  }
}

delete

Query parameters

idstringRequired

Responses

202

Accepted

No content

delete/v1/purchase-orders/modify

HTTPcURLJavaScriptPython

DELETE /v1/purchase-orders/modify?id=text HTTP/1.1
Accept: */*

202

Accepted

No content