Purchase Orders

Returns purchase orders filtered by query parameters.

Changed on

Returns purchase orders for the company authenticated by X-Api-Key, paginated. Without location_mytime_id, the list may include purchase orders for all locations the user may access; pass location_mytime_id to restrict results to a single location. Pass updated_after and/or updated_before to filter by when the purchase order was last updated, received_after and/or received_before to filter by when it was received, and statuses to filter by status. Results are ordered newest-first by id by default; pass sort and sort_order to override this.

get/purchase_orders

Request

  • Base URL
    https://partners-api.mytime.com/api
  • Auth
    API key in header X-Api-Key

Query parameters

location_mytime_idinteger

Location MyTime ID by which to filter results - Optional

updated_afterstring

Return only purchase orders with updated_at strictly after this value. ISO 8601 datetime (e.g. 2026-01-19 or 2026-01-19T00:00:00Z) is recommended.

updated_beforestring

Return only purchase orders with updated_at strictly before this value. ISO 8601 datetime (e.g. 2026-01-19 or 2026-01-19T00:00:00Z).

received_afterstring

Return only purchase orders received strictly after this value. The received time is the first receive event, or the first complete event when the order was never received; orders with neither are excluded. ISO 8601 datetime.

received_beforestring

Return only purchase orders received strictly before this value. Same received time rules as received_after. ISO 8601 datetime.

statusesstring

Comma-separated statuses to include. Allowed values: draft, ordered, received, checking_in, completed, canceled, disputed, requested.

pageinteger

Page number to return

per_pageinteger

row number to count as one page

sort'id' | 'updated_at'

Field to sort by. Default is 'id'. Allowed values: id, updated_at.

sort_order'asc' | 'desc'

Sort direction. Default is 'desc' (newest first). Allowed values: asc, desc.

vendorboolean

Whether to include vendor information

purchase_order_itemsboolean

Whether to include purchase order items

skuboolean

Whether to include sku information

vendor_skuboolean

Whether to include vendor sku information

shipment_itemsboolean

Whether to include shipment items

shipmentsboolean

Whether to include shipments

Headers

X-Subdomainstring

Merchant subdomain - Optional

X-Partnerstring

Partner key - Optional

Response

Purchase order list response

Changes

    • info

      added the new optional query request parameter received_after

    • info

      added the new optional query request parameter received_before

    • info

      added the new optional query request parameter statuses

    • info

      added the new optional query request parameter updated_before

    • info

      added the new optional query request parameter location_mytime_id

    • info

      added the new optional query request parameter sku

    • info

      added the new optional query request parameter sort

    • info

      added the new optional query request parameter sort_order

    • info

      added the new optional query request parameter updated_after

    • info

      added the new optional query request parameter vendor_sku