---
title: "PO detail with all its jobs"
method: GET
path: "/V1/purchase_orders/{po_number}"
tags: ["PurchaseOrders"]
---

# PO detail with all its jobs

`GET /V1/purchase_orders/{po_number}`

## Request

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

Returns the PO with its freelancer and all attached jobs (price, currency, language pair, order reference, delivery date). Used when an invoice cites a PO number.

## Response `200`

PO found

- PurchaseOrderDetail
  - `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
  - `freelancer` object, nullable
    - `id` string, uuid
    - `full_name` string
  - `jobs` Job[]
    - `id` string, uuid
    - `internal_id` string, uuid, nullable: Same as id
    - `plunet_id` string, nullable
    - `job_no` string, nullable
    - `short_job_type` string, nullable
    - `status` string
    - `price` number, float, nullable
    - `currency` string, nullable
    - `language_pair` string, nullable
    - `order_reference` string, nullable
    - `delivered_on` string, date-time, nullable

## Other responses

- `401`: unauthenticated
- `404`: PO 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)