---
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}`

## Request

- Base URL: `https://api.avionte.com/front-office`
- URL: `https://api.avionte.com/front-office/v1/company/purchase-order/{poId}`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Returns details about the specified company purchase order.

## Path parameters

- `poId` string, required

## Headers

- `RequestId` string, uuid: Unique request identifier in UUID format used to correlate request data to log entries and events.
- `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.dev/avionte/apis/bold-front-office-api.md) - [All operations](https://skmtc.dev/avionte/apis/bold-front-office-api/llms.txt) - [OpenAPI document](https://skmtc.dev/avionte/apis/bold-front-office-api/revisions/bd5996cbaa0f?raw)