Manufacturing Orders API

Get access to your manufacturing orders data through Cloudbox's v1 API.

Retrieving Manufacturing Orders

Manufacturing orders (production runs). The detail endpoint includes the MO's own bill-of-materials snapshot, operations, work-instruction steps, linked sales orders, and notes.

Use GET /api/v1/manufacturing-orders to page through every record in your organization, or GET /api/v1/manufacturing-orders/{id} to fetch a single record with its related data. The id is a UUID, and a 404 means it doesn't exist in your organization.

API Endpoint

GET
/api/v1/manufacturing-orders
GET
/api/v1/manufacturing-orders/{id}

Required Headers

Every request must include the following:

Header Key
Description
org-api-key
Your Organization API key. Contact Cloudbox Support For Access: support@cloudboxapp.com.
user-api-key
Your User API Key

Requests missing either header will return 401 Unauthorized

Example Request

bash curl -X GET "https://app.cloudboxapp.com/api/v1/manufacturing-orders?limit=100" \ -H "org-api-key: YOUR_ORG_API_KEY" \ -H "user-api-key: YOUR_USER_API_KEY" \ -H "Accept: application/json"

Response Schema

Column
Type
Description
id
string (uuid)
Unique ID
run_number
string
Filterable (exact). Sortable
status
string
Filterable (exact)
product_id
string, nullable
References Product. Filterable (exact)
sku_id
string
References SKU. Filterable (exact)
recipe_variant_id
string (uuid), nullable
References RecipeVariants
station_id
string (uuid), nullable
References wi_station. Filterable (exact)
sales_order_id
string (uuid), nullable
References SalesOrders. Filterable (exact)
planned_quantity
number
actual_quantity
number, nullable
so_required_quantity
number, nullable
uom
string, nullable
operator_id
string (uuid), nullable
started_at
string (ISO 8601), nullable
Sortable
completed_at
string (ISO 8601), nullable
Sortable
notes
string, nullable
cost_materials
number, nullable
cost_labor
number, nullable
cost_equipment
number, nullable
cost_total
number, nullable
cost_computed_at
string (ISO 8601), nullable
created_at
string (ISO 8601)
Creation timestamp (UTC). Sortable
updated_at
string (ISO 8601)
Last update timestamp (UTC)
product
object
Detail endpoint only. Related record: id, name
sku
object
Detail endpoint only. Related record: id, name, tracking_id
bom_variant
object
Detail endpoint only. Related record: id, name
station
object
Detail endpoint only. Related record: id, name, area
materials
array of objects
Detail endpoint only. Related records: ingredient_product_id, quantity, uom, liquid_fluid_ounce_quantity, sort_order, ingredient
operations
array of objects
Detail endpoint only. Related records: id, recipe_operation_id, step_number, name, description, resource_id, planned_minutes, actual_minutes, planned_cost, actual_cost, completed_at, completed_by
steps
array of objects
Detail endpoint only. Related records: id, wi_step_id, type, title, instructions, required, estimated_minutes, sort_order, target_weight, weight_threshold, weight_unit, station_id
sales_orders
array of objects
Detail endpoint only. Related records: sales_order_id, required_quantity
mo_notes
array of objects
Detail endpoint only. Related records: id, body, author_id, source, created_at

Filters

limitPage size (default 100, max 1000)
offsetNumber of records to skip (default 0)
sortOne of: run_number, created_at, started_at, completed_at
orderasc | desc
statusplanned | in_progress | completed | cancelled
run_numberExact MO number match
product_idMOs producing this product
sku_idMOs producing this SKU
sales_order_idMOs linked to this sales order
station_idMOs run at this station
completed_sinceOnly records completed at or after this ISO 8601 timestamp
updated_sinceOnly records updated at or after this ISO 8601 timestamp
default sortcreated_at descending

Errors

Cloudbox uses standard HTTP status codes to indicate API success or failure:

  • 200–299 – Request succeeded
  • 400 – Bad request (missing parameters, invalid values)
  • 401 – Unauthorized (missing or invalid API keys)
  • 404 – Resource not found
  • 429 – Too many requests (rate limited)