> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fire.rest/llms.txt
> Use this file to discover all available pages before exploring further.

# Get fulfillment status

> Shows how much of each purchase order line has been received via linked goods receipts.

<ParamField header="x-api-key" type="string" required>
  API key with `inventory:read` scope.
</ParamField>

<ParamField path="vendorId" type="string" required>
  Vendor UUID.
</ParamField>

<ParamField path="orderId" type="string" required>
  Purchase order UUID.
</ParamField>

<ResponseField name="purchase_order_id" type="string">
  The PO UUID.
</ResponseField>

<ResponseField name="status" type="string">
  Current PO status.
</ResponseField>

<ResponseField name="lines" type="object[]">
  Per line: `purchase_order_line_id`, `item_id`, `ordered_qty_base`, `received_qty_base`, `pending_qty_base`.
</ResponseField>

<ResponseField name="total_ordered_qty_base" type="number">
  Sum of ordered quantities (base units).
</ResponseField>

<ResponseField name="total_received_qty_base" type="number">
  Sum received so far.
</ResponseField>

<ResponseField name="total_pending_qty_base" type="number">
  Sum still pending.
</ResponseField>

<ResponseField name="linked_goods_receipt_ids" type="string[]">
  Goods receipts that fulfilled this PO.
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "purchase_order_id": "po_01j5k...",
    "status": "PARTIALLY_RECEIVED",
    "lines": [
      {
        "purchase_order_line_id": "pol_01...",
        "item_id": "itm_chicken_01...",
        "ordered_qty_base": 10000,
        "received_qty_base": 6000,
        "pending_qty_base": 4000
      }
    ],
    "total_ordered_qty_base": 10000,
    "total_received_qty_base": 6000,
    "total_pending_qty_base": 4000,
    "linked_goods_receipt_ids": ["rcpt_01j5k..."]
  }
  ```
</ResponseExample>