---
title: "List purchase orders for a freelancer"
method: GET
path: "/V1/freelancers/{freelancer_id}/purchase_orders"
tags: ["PurchaseOrders"]
---

# List purchase orders for a freelancer

`GET /V1/freelancers/{freelancer_id}/purchase_orders`

## Request

- Base URL: `https://api.worders.net`
- URL: `https://api.worders.net/V1/freelancers/{freelancer_id}/purchase_orders`
- Auth: one of:
  - API key in cookie `_worders_session`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/worders/apis/worders-api-v1/docs/V1/freelancers/:freelancer_id/purchase_orders/get.ts> (a function with typed inputs; its response is checked against the schema)

List purchase orders attached to a freelancer over a period. By default `deleted` and `deprecated` POs are excluded.

## Query parameters

- `period_start` string, date
- `period_end` string, date
- `status` string[]
- `page` integer
- `per_page` integer

## Response `200`

pagination: second page returns correct slice

- object
  - `data` PurchaseOrderSummary[]
    - `id` string, uuid
    - `internal_id` string, uuid, nullable: Same as id
    - `po_number` string
    - `currency` string
    - `status` string
    - `created_at` string, date-time
    - `total_amount` number, float
    - `jobs_count` integer
    - `freelancer` object
      - `id` string, uuid
      - `full_name` string
  - `meta` PaginationMeta
    - `total` integer
    - `page` integer
    - `per_page` integer

## Other responses

- `404`: freelancer not found

---

[API](https://skmtc.dev/worders/apis/worders-api-v1.md) - [All operations](https://skmtc.dev/worders/apis/worders-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/worders/apis/worders-api-v1/revisions/ef0debe7af75?raw)