List purchase orders

GET

/purchaseorders

List all purchase orders.

Request

Authorization

OAuth 2.0

Implicit

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Authorize URL: https://accounts.zoho.com/oauth/v2/auth

Query Params

Responses

🟢200OK

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/purchaseorders?purchaseorder_number=PO-00001&reference_number=ER/0034&date=2014-02-10&status=draft&item_description=&vendor_name=&total=40&vendor_id=460000000026049&last_modified_time=2014-02-10T15:26:26+0530&item_id=460000000027009&filter_by=Status.All&search_text=&sort_column=created_time&custom_field=&page=1&per_page=200'

Response Example

{
    "code": 0,
    "message": "success",
    "purchaseorders": [
        {
            "purchaseorder_id": "460000000068231",
            "vendor_id": " ",
            "vendor_name": "Bowmen and co",
            "status": "active",
            "purchaseorder_number": "PO-0001",
            "reference_number": " ",
            "date": "2013-10-01",
            "delivery_date": "2014-02-10",
            "currency_id": "460000000000097",
            "currency_code": "USD",
            "price_precision": 2,
            "total": 10000,
            "has_attachment": false,
            "created_time": "2016-06-05T02:30:08-0700",
            "last_modified_time": "string",
            "custom_fields": [
                {
                    "customfield_id": "46000000012845",
                    "value": "Normal"
                }
            ]
        }
    ]
}

Modified at 2025-10-12 16:28:37

Create a purchase order

Update a purchase order using a custom field's unique value