Purchase Order Filters

GET /api/external/v1/po/getFilters

Returns the valid filter values (channels, batches, statuses, carriers, warehouses) for the account — use this to populate filter dropdowns / validate filter values before calling getOrdersBatchwise.

Response 200 OK

{
  "success": true,
  "status_code": 200,
  "message": "Successfully fetched purchase order filters",
  "data": {
    "filters": {
      "channels": ["b2b", "blinkit"],
      "batches": ["BATCH-01", "BATCH-02"],
      "status": ["NEW", "ASSIGNED", "HOLD", "FULFILLED", "CANCELLED"],
      "carriers": [ { "carrier_id": "b6b2a3e1-....", "carrier": "delhivery", "carrier_name": "Delhivery" } ],
      "warehouses": [ { "warehouse_id": "e1a2b3c4-....", "warehouse_name": "Mumbai FC" } ]
    }
  }
}

status lists the distinct readable_status labels currently present on the account's POs — these are exactly the values filters.status accepts on getOrdersBatchwise / getOrdersCount. On accounts without custom status labels they are the same as the fixed status values (NEW, UNCONFIRMED, ASSIGNED, HOLD, FULFILLED, CANCELLED, EXPIRED); only statuses that at least one PO currently has are returned. See Purchase Order Object Reference.