---
title: "Returns purchase orders filtered by query parameters."
method: GET
path: "/purchase_orders"
tags: ["Purchase Orders"]
---

# Returns purchase orders filtered by query parameters.

`GET /purchase_orders`

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 to return only purchase orders updated after that timestamp. Results are ordered newest-first by id by default; pass sort and sort_order to override this.

## Query parameters

- `location_mytime_id` integer
- `updated_after` string
- `page` integer
- `per_page` integer
- `sort` 'id' | 'updated_at'
- `sort_order` 'asc' | 'desc'
- `vendor` boolean
- `purchase_order_items` boolean
- `sku` boolean
- `vendor_sku` boolean
- `shipment_items` boolean
- `shipments` boolean

## Headers

- `X-Subdomain` string
- `X-Partner` string

## Response `200`

Purchase order list response

- object
  - `purchase_orders` PurchaseOrder[]
    - `id` integer
    - `deleted_at` string
    - `invoice_number` string
    - `last_exported_at` string
    - `non_null_deleted` integer
    - `ordered_at` string
    - `po_number` string
    - `shipping_cost` number
    - `status` integer
    - `created_at` string
    - `updated_at` string
    - `external_id` string
    - `location_id` integer
    - `vendor_id` integer
    - `vendor_payment_method_id` integer

## Other responses

- `401` — Unauthorized
- `422` — Invalid parameters
- `500` — Internal Server Error
- `504` — Gateway Timeout

---

[API](https://skmtc.net/mytime/apis/mytime-partners-api.md) · [All operations](https://skmtc.net/mytime/apis/mytime-partners-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mytime/mytime-partners-api/versions/728bf22325fc/schema)