You can access production orders in an Uphance account using these API calls. You can retrieve all production orders or new production orders since a certain ID.
GET all production orders
Retrieve all production orders. This endpoint will return 50 orders at most (see the Pagination section to learn how to access all pages).
$ curl https://api.uphance.com/production_orders \
-H "Authorization: ACCESS_TOKEN"
Example response:
{
"production_orders": [
{
"id": 23670,
"production_order_number": "1311",
"created_at": "2025-04-28T15:11:18.000+01:00",
"updated_at": "2025-04-28T15:41:55.000+01:00",
"items_total": "46.0",
"items_tax": "0.0",
"subtotal": "46.0",
"total_tax": "0.0",
"grand_total": "46.0",
"total_quantity": 58,
"tax_level": "0.0",
"shipping_cost": "0.0",
"shipping_tax": "0.0",
"confirmed_at": "2025-04-28T15:18:09.000+01:00",
"due_date": null,
"in_warehouse_date": null,
"drop_id": null,
"notes": null,
"internal_notes": null,
"currency": "AUD",
"company_id": 59576,
"company_name": "Adine Undone",
"season_id": 12864,
"organisation_id": 35802,
"status": "CONFIRMED",
"delivery_status": "Receiving",
"financial_status": "Not Paid",
"warehouses": [
"Primary warehouse"
],
"payment_terms": null,
"delivery_terms": null,
"line_items": [
{
"id": 142101,
"product_id": 134509,
"product_name": "2470_Eighteen",
"product_identifier": "2470 eighteen sweater 1 wrap knit sweater united kingdom",
"variation_id": 286452,
"color": "Blue",
"unit_tax": "0.0",
"tax_level": "0.0",
"unit_price": "0.0",
"original_price": "0.0",
"warehouse": "Primary warehouse",
"percentage_discount": "0.0",
"bundle_line_item": false,
"comments": "",
"product_brand": "Brand Twelve",
"country_of_origin": "",
"intrastat_code": "",
"product_cover_image": "https://woah2.uphance.com/uploads/product/image/134509/White_4.jpg",
"variation_images": [
"https://woah2.uphance.com/uploads/product_image/image/90207/BLUE5.jpg"
],
"line_quantities": [
{
"id": 744795,
"size": "36",
"quantity": 0,
"sku_number": "2470 EIGHTEEN SWEATER 1 WRAP KNIT SWEATER UNITED KINGDOM-BLUE_FOR_SHIRT3-36",
"sku_id": 1437432,
"inventory_id": 3737041,
"upc_number": "",
"bundle_components": []
},
{
"id": 744796,
"size": "38",
"quantity": 33,
"sku_number": "2470 EIGHTEEN SWEATER 1 WRAP KNIT SWEATER UNITED KINGDOM-BLUE_FOR_SHIRT3-38",
"sku_id": 1437433,
"inventory_id": 3737056,
"upc_number": "",
"bundle_components": []
}
]
},
{
"id": 142102,
"product_id": 135462,
"product_name": "2470_Eighteen Copy",
"product_identifier": "2470 eighteen sweater 1 wrap knit sweater united kingdom Copy",
"variation_id": 288174,
"color": "Blue",
"unit_tax": "0.0",
"tax_level": "0.0",
"unit_price": "0.0",
"original_price": "0.0",
"warehouse": "Primary warehouse",
"percentage_discount": "0.0",
"bundle_line_item": false,
"comments": "",
"product_brand": null,
"country_of_origin": "",
"intrastat_code": "",
"product_cover_image": null,
"variation_images": [],
"line_quantities": [
{
"id": 744797,
"size": "36",
"quantity": 1,
"sku_number": "2470 eighteen sweater 1 wrap knit sweater united kingdom Copy-BLUE_FOR_SHIRT3-36",
"sku_id": 1444281,
"inventory_id": 3806907,
"upc_number": "",
"bundle_components": []
},
{
"id": 744798,
"size": "38",
"quantity": 11,
"sku_number": "2470 eighteen sweater 1 wrap knit sweater united kingdom Copy BLUE_FOR_SHIRT3-38",
"sku_id": 1444282,
"inventory_id": 3806922,
"upc_number": "",
"bundle_components": []
}
]
},
{
"id": 142103,
"product_id": 135462,
"product_name": "2470_Eighteen Copy",
"product_identifier": "2470 eighteen sweater 1 wrap knit sweater united kingdom Copy",
"variation_id": 288175,
"color": "White",
"unit_tax": "0.0",
"tax_level": "0.0",
"unit_price": "0.0",
"original_price": "0.0",
"warehouse": "Primary warehouse",
"percentage_discount": "0.0",
"bundle_line_item": false,
"comments": "",
"product_brand": null,
"country_of_origin": "",
"intrastat_code": "",
"product_cover_image": null,
"variation_images": [],
"line_quantities": [
{
"id": 744799,
"size": "36",
"quantity": 0,
"sku_number": "2470 eighteen sweater 1 wrap knit sweater united kingdom Copy-WHITE_FOR_SHIRT1-36",
"sku_id": 1444283,
"inventory_id": 3806937,
"upc_number": "",
"bundle_components": []
},
{
"id": 744800,
"size": "38",
"quantity": 11,
"sku_number": "2470 eighteen sweater 1 wrap knit sweater united kingdom Copy-WHITE_FOR_SHIRT1-38",
"sku_id": 1444284,
"inventory_id": 3806952,
"upc_number": "",
"bundle_components": []
}
]
},
{
"id": 142104,
"product_id": 136054,
"product_name": "2766_Ten Copy (Montblanc)",
"product_identifier": "2766_tencaps Copy - Montblanc",
"variation_id": 289440,
"color": "White",
"unit_tax": "0.0",
"tax_level": "0.0",
"unit_price": "23.0",
"original_price": "23.0",
"warehouse": "Primary warehouse",
"percentage_discount": "0.0",
"bundle_line_item": false,
"comments": "",
"product_brand": null,
"country_of_origin": "",
"intrastat_code": "",
"product_cover_image": null,
"variation_images": [],
"line_quantities": [
{
"id": 744801,
"size": "36",
"quantity": 1,
"sku_number": "2766_tencaps Copy - Montblanc-WHITE_FOR_SHIRT1-36",
"sku_id": 1448755,
"inventory_id": 3885194,
"upc_number": "",
"bundle_components": []
},
{
"id": 744802,
"size": "38",
"quantity": 1,
"sku_number": "2766_tencaps Copy - Montblanc-WHITE_FOR_SHIRT1-38",
"sku_id": 1448756,
"inventory_id": 3885210,
"upc_number": "",
"bundle_components": []
}
]
}
]
},
{
"id": 23620,
"production_order_number": "1307",
"created_at": "2025-04-23T18:58:23.000+01:00",
"updated_at": "2025-04-25T09:14:53.000+01:00",
"items_total": "300.0",
"items_tax": "9.0",
"subtotal": "300.0",
"total_tax": "9.0",
"grand_total": "309.0",
"total_quantity": 15,
"tax_level": "3.0",
"shipping_cost": "0.0",
"shipping_tax": "0.0",
"confirmed_at": "2025-04-23T18:59:07.000+01:00",
"due_date": null,
"in_warehouse_date": null,
"drop_id": null,
"notes": null,
"internal_notes": null,
"currency": "EUR",
"company_id": 59578,
"company_name": "Bolide",
"season_id": 12328,
"organisation_id": 35802,
"status": "CONFIRMED",
"delivery_status": "Receiving",
"financial_status": "Not Paid",
"warehouses": [
"Primary warehouse"
],
"payment_terms": null,
"delivery_terms": null,
"line_items": [
{
"id": 141951,
"product_id": 111558,
"product_name": "33-8110O - Knit L/S Sweater",
"product_identifier": "33-8110O",
"variation_id": 235608,
"color": "Black",
"unit_tax": "0.6",
"tax_level": "3.0",
"unit_price": "20.0",
"original_price": "20.0",
"warehouse": "Primary warehouse",
"percentage_discount": "0.0",
"bundle_line_item": false,
"comments": "",
"product_brand": "M Made in Italy",
"country_of_origin": "IT",
"intrastat_code": "",
"product_cover_image": "https://woah2.uphance.com/uploads/product/image/111558/33-8110O-White.jpg",
"variation_images": [
"https://woah2.uphance.com/uploads/product_image/image/57009/33_81100__top___-__14_8830__short_.jpg?"
],
"line_quantities": [
{
"id": 744165,
"size": "XS",
"quantity": 3,
"sku_number": "33-8110O-BL-XS",
"sku_id": 1208112,
"inventory_id": 1243916,
"upc_number": "1123600039658",
"bundle_components": []
},
{
"id": 744166,
"size": "S",
"quantity": 4,
"sku_number": "33-8110O-BL-S",
"sku_id": 1208113,
"inventory_id": 1243920,
"upc_number": "1123600039665",
"bundle_components": []
},
{
"id": 744167,
"size": "M",
"quantity": 0,
"sku_number": "33-8110O-BL-M",
"sku_id": 1208114,
"inventory_id": 1243924,
"upc_number": "1123600039672",
"bundle_components": []
},
{
"id": 744168,
"size": "L",
"quantity": 0,
"sku_number": "33-8110O-BL-L",
"sku_id": 1208115,
"inventory_id": 1243928,
"upc_number": "1123600039689",
"bundle_components": []
},
{
"id": 744169,
"size": "XL",
"quantity": 0,
"sku_number": "33-8110O-BL-XL",
"sku_id": 1208116,
"inventory_id": 1243932,
"upc_number": "1123600039696",
"bundle_components": []
}
]
},
{
"id": 141952,
"product_id": 111558,
"product_name": "33-8110O - Knit L/S Sweater",
"product_identifier": "33-8110O",
"variation_id": 235609,
"color": "White",
"unit_tax": "0.6",
"tax_level": "3.0",
"unit_price": "20.0",
"original_price": "20.0",
"warehouse": "Primary warehouse",
"percentage_discount": "0.0",
"bundle_line_item": false,
"comments": "",
"product_brand": "M Made in Italy",
"country_of_origin": "IT",
"intrastat_code": "",
"product_cover_image": "https://woah2.uphance.com/uploads/product/image/111558/33-8110O-White.jpg",
"variation_images": [
"https://woah2.uphance.com/uploads/product_image/image/57010/33-8110O-White.jpg"
],
"line_quantities": [
{
"id": 744171,
"size": "S",
"quantity": 4,
"sku_number": "33-8110O-WH-S",
"sku_id": 1219991,
"inventory_id": 1291392,
"upc_number": "1123600039719",
"bundle_components": []
},
{
"id": 744172,
"size": "M",
"quantity": 0,
"sku_number": "33-8110O-WH-M",
"sku_id": 1219992,
"inventory_id": 1291396,
"upc_number": "1123600039726",
"bundle_components": []
},
{
"id": 744173,
"size": "L",
"quantity": 0,
"sku_number": "33-8110O-WH-L",
"sku_id": 1219993,
"inventory_id": 1291400,
"upc_number": "1123600039733",
"bundle_components": []
},
{
"id": 744174,
"size": "XL",
"quantity": 0,
"sku_number": "33-8110O-WH-XL",
"sku_id": 1219994,
"inventory_id": 1291404,
"upc_number": "1123600039740",
"bundle_components": []
}
]
}
]
}
],
"meta": {
"current_page": 1,
"next_page": null,
"prev_page": null,
"total_pages": 1,
"total_count": 2
}
}
GET production orders with filter parameters
Retrieve all production orders since a certain order ID. This endpoint will return 50 orders at most (see the Pagination section to learn how to access all pages).
$ curl https://api.uphance.com/production_orders?since_id=PRODUCTION_ORDER_ID \
-H "Authorization: ACCESS_TOKEN"
Retrieve all production orders created since a certain date
$ curl https://api.uphance.com/production_orders?since_created_at=DD/MM/YYYY \
-H "Authorization: ACCESS_TOKEN"
Filter by season
$ curl https://api.uphance.com/production_orders?by_season[]=SEASON_ID_1&by_season[]=SEASON_ID_2 \
-H "Authorization: ACCESS_TOKEN"
Filter by warehouse
$ curl https://api.uphance.com/production_orders?by_warehouse[]=W_ID_1&by_warehouse[]=W_ID_1 \
-H "Authorization: ACCESS_TOKEN"
Filter by manufacturer
$ curl https://api.uphance.com/production_orders?by_company[]=MC_ID_1&by_company[]=MC_ID_2 \
-H "Authorization: ACCESS_TOKEN"
Filter by production order state
Valid states are draft, confirmed, complete and cancelled.
$ curl https://api.uphance.com/production_orders?by_state[]=STATE_1&by_state[]=STATE_2 \
-H "Authorization: ACCESS_TOKEN"
Filter by delivery status
Valid delivery statuses are not_received, receiving and all_received.
$ curl https://api.uphance.com/production_orders?by_delivery_status[]=STATUS_1&by_delivery_status[]=STATUS_2 \
-H "Authorization: ACCESS_TOKEN"
Filter by search query
$ curl https://api.uphance.com/production_orders?by_q=QUERY \
-H "Authorization: ACCESS_TOKEN"
Filter by production stage
If include_stages is set to true, production stage history for each line item will be included in the response.
$ curl https://api.uphance.com/production_orders?include_stages=true \
-H "Authorization: ACCESS_TOKEN"
Example response:
{
"production_orders": [
{
"id": 23621,
"production_order_number": "1308",
"created_at": "2025-04-23T19:07:33.000+01:00",
"updated_at": "2025-04-26T05:51:21.000+01:00",
"items_total": "243.32",
"items_tax": "7.3",
"subtotal": "243.32",
"total_tax": "7.3",
"grand_total": "250.62",
"total_quantity": 14,
"tax_level": "3.0",
"shipping_cost": "0.0",
"shipping_tax": "0.0",
"confirmed_at": "2025-04-23T19:07:40.000+01:00",
"due_date": null,
"in_warehouse_date": null,
"drop_id": null,
"notes": null,
"internal_notes": null,
"currency": "CAD",
"company_id": 59582,
"company_name": "Tribal Sportswear Inc.",
"season_id": 12328,
"organisation_id": 35802,
"status": "COMPLETE",
"delivery_status": "All Received",
"financial_status": "Not Paid",
"warehouses": [
"Primary warehouse"
],
"payment_terms": null,
"delivery_terms": null,
"line_items": [
{
"id": 141953,
"product_id": 111591,
"product_name": "3465O-3206 - Tie Frt V Neck Blouse",
"product_identifier": "3465O-3206",
"variation_id": 235674,
"color": "Lt. Peach",
"unit_tax": "0.52",
"tax_level": "3.0",
"unit_price": "17.38",
"original_price": "17.38",
"warehouse": "Primary warehouse",
"percentage_discount": "0.0",
"bundle_line_item": false,
"comments": "",
"product_brand": "Tribal",
"country_of_origin": "CN",
"intrastat_code": "",
"Product_cover_image": "https://uphance.com/uploads/product/image/111591/3465o-3206-1813-A.jpg",
"variation_images": [ "https://uphance.com/uploads/product_image/image/57061/3465o-3206-1813-A.jpg"
],
"production_stages": {
"current_stage": {
"name": "Packing",
"start_time": "2025-04-26T18:08:22.000Z",
"end_time": null,
"stage_color": "#89d7ca",
"status": "In Progress"
},
"past_stages": [
{
"name": "Cutting",
"start_time": "2025-04-25T18:08:22.000Z",
"end_time": "2025-04-25T18:08:26.000Z",
"stage_color": "#89d7ca",
"status": "Completed"
},
{
"name": "Sewing",
"start_time": "2025-04-24T18:08:29.000Z",
"end_time": "2025-04-24T18:08:32.000Z",
"stage_color": "#80c0d6",
"status": "Completed"
}
]
},
"line_quantities": [
{
"id": 744175,
"size": "XS",
"quantity": 6,
"sku_number": "3465O-3206-LT-XS",
"sku_id": 1208296,
"inventory_id": 1244652,
"upc_number": "1123600040029",
"bundle_components": []
},
{
"id": 744176,
"size": "S",
"quantity": 8,
"sku_number": "3465O-3206-LT-S",
"sku_id": 1208297,
"inventory_id": 1244656,
"upc_number": "1123600040036",
"bundle_components": []
},
{
"id": 744177,
"size": "M",
"quantity": 0,
"sku_number": "3465O-3206-LT-M",
"sku_id": 1208298,
"inventory_id": 1244660,
"upc_number": "1123600040043",
"bundle_components": []
},
{
"id": 744178,
"size": "L",
"quantity": 0,
"sku_number": "3465O-3206-LT-L",
"sku_id": 1208299,
"inventory_id": 1244664,
"upc_number": "1123600040050",
"bundle_components": []
},
{
"id": 744179,
"size": "XL",
"quantity": 0,
"sku_number": "3465O-3206-LT-XL",
"sku_id": 1208300,
"inventory_id": 1244668,
"upc_number": "1123600040067",
"bundle_components": []
}
]
}
]
}
],
"meta": {
"current_page": 1,
"next_page": null,
"prev_page": null,
"total_pages": 1,
"total_count": 1
}
}
Filter by production stage status
Note: Requires include_stages=true.
Filters production orders based on the status of their line items' production stages. Valid values for by_stage_status are: not_started, in_progress, pending (includes both not_started and in_progress), completed.
$ curl https://api.uphance.com/production_orders?include_stages=true&by_stage_status=STATUS \
-H "Authorization: ACCESS_TOKEN"
Filter by Production Stage Name
Note: Requires include_stages=true.
Filters production orders that contain a specific production stage name.
By default, the stage can be in any status. To narrow the search by stage status, include the by_stage_status parameter.
$ curl https://api.uphance.com/production_orders?include_stages=true&by_stage_name[]=NAME_1&by_stage_name[]=NAME_2 \
-H "Authorization: ACCESS_TOKEN"
To filter by both stage name and status:
$ curl https://api.uphance.com/production_orders?include_stages=true&by_stage_name[]=STAGE_NAME&by_stage_status=STATUS \
-H "Authorization: ACCESS_TOKEN"
GET production stages/timeline for a production line
$ curl https://api.uphance.com/production_order_line_items/PRODUCTION_ORDER_LINE_ITEM_ID/production_timeline \
-H "Authorization: ACCESS_TOKEN"
Example response:
{
"production_order_line_item": {
"id": 140828,
"product_id": 118145,
"product_name": "Tia Tank Dress",
"product_identifier": "Tia Tank Dress",
"variation_id": 251816,
"color": "Black",
"unit_tax": "0.99",
"tax_level": "3.0",
"unit_price": "33.0",
"original_price": "33.0",
"percentage_discount": "0.0",
"production_stages": {
"current_stage": {
"name": "Packing",
"start_time": "2025-03-28T18:23:15.000+05:30",
"end_time": null,
"stage_color": "#a29090",
"status": "In Progress"
},
"past_stages": [
{
"name": "Cutting",
"start_time": "2025-03-28T12:53:00.000Z",
"end_time": "2025-03-28T12:53:03.000Z",
"stage_color": "#b86f6f",
"status": "Completed"
},
{
"name": "Sewing",
"start_time": "2025-03-28T12:53:07.000Z",
"end_time": "2025-03-28T12:53:10.000Z",
"stage_color": "#973094",
"status": "Completed"
}
]
},
}
}
GET production stages/timeline for bulk line items
$ curl https://api.uphance.com/production_order_line_items/production_timeline_bulk?ids=ID_1,ID_2,ID_3 \
-H "Authorization: ACCESS_TOKEN"
OR
$ curl https://api.uphance.com/production_order_line_items/production_timeline_bulk?ids[]=ID_1&ids[]=ID_2&ids[]=ID_3 \
-H "Authorization: ACCESS_TOKEN"
Filter by production stage status
Filters line items based on the status of their production stages.
Valid values for by_stage_status are: not_started, in_progress, pending (includes both not_started and in_progress), completed.
$ curl https://api.uphance.com/production_order_line_items/production_timeline_bulk?by_stage_status=STATUS \
-H "Authorization: ACCESS_TOKEN"
Filter by production stage name
Filters line items that contain a specific production stage name. By default, the stage can be in any status. To narrow the search by stage status, include the by_stage_status parameter.
$ curl https://api.uphance.com/production_order_line_items/production_timeline_bulk?by_stage_name[]=NAME_1&by_stage_name[]=NAME_2 \
-H "Authorization: ACCESS_TOKEN"
Pagination
GET API endpoints that return multiple records use pagination to limit the number of records returned in a single request. You should use the paging metadata included in the response JSON body to navigate to the subsequent page if you require all records. To avoid rate limiting, you should download each page sequentially and not in parallel.
The metadata is included in a meta hash at the top level of the JSON document. The following example shows the metadata for the first page in a two-page collection.
"meta": {
"current_page": 1,
"next_page": 2,
"prev_page": null,
"total_pages": 2,
"total_count": 78
}
To fetch the second or subsequent pages, repeat the same call with a page parameter. For example, to get page 2 on Get all production orders, your call would look like this:
GET https://api.uphance.com/production_orders?page=2
If no meta hash is present in the response, you can assume that responses from that endpoint are not paginated.