---
title: "Get Company PO by PO ID"
method: GET
path: "/v1/company/purchase-order/{poId}"
tags: ["Companies"]
---

# Get Company PO by PO ID

`GET /v1/company/purchase-order/{poId}`

Returns details about the specified company purchase order.

## Path parameters

- `poId` string, required

## Headers

- `RequestId` string, uuid — The unique request identifier used to correlate request data with log entries and events, formatted as a UUID.
- `FrontOfficeTenantId` integer
- `Tenant` string

## Response `200`

The company purchase order.

- CompanyPo
  - `po_ID` integer — The identifier for the purchase order.
  - `po_comp` integer — The identifier for the company.
  - `po_num` string — The purchase order number.
  - `po_amount` number — The net amount of the purchase order.
  - `po_amountused` number — The used amount of the purchase order.
  - `po_remaining` number — The remaining amount of the purchase order.
  - `po_threshold` number — The purchase order threshold amount.
  - `po_notify` boolean — An indication of whether a notification email will be sent when the remaining amount reaches the threshold.
  - `notify_users` string — The IDs of the users who will be sent notification emails.
  - `notify_sent` boolean — An indication of whether a notification email has been sent to the specified users or not.
  - `notify_sent_date` string, date-time — The date when the notification was sent. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats and also supports fractional seconds, such as YYYY-MM-DDTHH:mm:ss.sss. For example, 2024-12-01, 2024-12-01T14:30:00, and 2024-12-01T14:30:00.546.
  - `po_description` string — The purchase order description.
  - `is_active` boolean — An indication of whether the purchase order is active or inactive.
  - `sendnotification` boolean — An indication of whether a notification email has been sent to the specified users or not.
  - `comp_name` string — The name of the company associated with the purchase order.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Access Denied
- `404` — Not found
- `405` — Unsupported method
- `406` — Unsupported format(s) indicated by Accept header
- `415` — Unsupported format(s) indicated by the Content-Type header
- `429` — Too many requests
- `500` — An unexpected error occurred
- `502` — Service Unavailable
- `504` — Gateway Timeout

---

[API](https://skmtc.net/avionte/apis/aviont-partner-authorization-api.md) · [All operations](https://skmtc.net/avionte/apis/aviont-partner-authorization-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/avionte/aviont-partner-authorization-api/revisions/846b33e4e71b/schema)