---
title: "POST /V1.0/PurchaseOrders/query"
method: POST
path: "/V1.0/PurchaseOrders/query"
tags: ["PurchaseOrders"]
---

# POST /V1.0/PurchaseOrders/query

`POST /V1.0/PurchaseOrders/query`

## Headers

- `ApiIntegrationCode` string, required
- `UserName` string, required
- `Secret` string, required
- `ImpersonationResourceId` string

## Request body

- QueryModel
  - `maxRecords` integer
  - `includeFields` string[]
  - `filter` Filter[]
    - `op` string
    - `field` string
    - `udf` boolean
    - `value` object — Can be either an Integer, String, Boolean, an Array of Integers, or an Array of Strings.
    - `items` Filter[] — An Array of Filter objects

## Response `200`

OK

- QueryActionResultPurchaseOrderModelPurchaseOrder
  - `items` PurchaseOrderModel[]
    - `id` integer
    - `cancelDateTime` string, date-time
    - `createDateTime` string, date-time
    - `creatorResourceID` integer
    - `externalPONumber` string
    - `fax` string
    - `freight` number, double
    - `generalMemo` string
    - `impersonatorCreatorResourceID` integer
    - `internalCurrencyFreight` number, double
    - `latestEstimatedArrivalDate` string, date-time
    - `paymentTerm` integer
    - `phone` string
    - `purchaseForCompanyID` integer
    - `purchaseOrderNumber` string
    - `purchaseOrderTemplateID` integer
    - `shippingDate` string, date-time
    - `shippingType` integer
    - `shipToAddress1` string
    - `shipToAddress2` string
    - `shipToCity` string
    - `shipToName` string
    - `shipToPostalCode` string
    - `shipToState` string
    - `showEachTaxInGroup` boolean
    - `showTaxCategory` boolean
    - `status` integer
    - `submitDateTime` string, date-time
    - `taxRegionID` integer
    - `useItemDescriptionsFrom` integer
    - `vendorID` integer
    - `vendorInvoiceNumber` string
    - `additionalVendorInvoiceNumbers` string
  - `pageDetails` PagingModel
    - `count` integer
    - `requestCount` integer
    - `prevPageUrl` string
    - `nextPageUrl` string

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/autotask/apis/datto-autotask-psa-rest-api.md) · [All operations](https://skmtc.net/autotask/apis/datto-autotask-psa-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/autotask/datto-autotask-psa-rest-api/versions/b5e89df4589e/schema)