List open POs and which forecast column they flow through

GET /api/v1/businesses/{business_id}/cfo-portal/po-forecast-settings

List every open PO with its forecast attribution.

Returns: POForecastSettingsResponse — each row identifies whether the PO flows through inventory (no linked bill yet) or ap_out (a Bill exists with source_inventory_order_id pointing at this PO), plus the amount and date the forecast uses.

Why it matters: Operators auditing the forecast can pinpoint why a given dollar shows up in AP Out vs. Inventory Payments without having to cross-reference the bills and PO tables manually.

Operation ID: cfo_portal_po_forecast_settings_api_v1_businesses__business_id__cfo_portal_po_forecast_settings_get · View as markdown · OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Parameters

Path

business_id string required

Responses

200 Successful Response

items array · POForecastDetail POForecastDetail
12 fields
po_id string required
po_number string
vendor_name string
status string required
total_cents integer
balance_cents integer
expected_paid_on string · date
is_linked_to_bill boolean
linked_bill_id string
linked_bill_due_date string · date
linked_bill_remaining_balance_cents integer
forecast_column string required

One of: inventory, ap_out

total_inventory_outflow_cents integer
total_ap_outflow_cents integer

401 Unauthorized - Authentication required

403 Forbidden - Insufficient permissions

404 Not Found - Resource does not exist

422 Validation Error

detail array · ValidationError ValidationError
5 fields
loc array · string | integer required
msg string required
type string required
input object
ctx object