You can access production orders in your Uphance account by 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": 26988,
"production_order_number": "1895",
"created_at": "2026-08-10T06:07:24.000Z",
"updated_at": "2026-08-10T06:12:48.000Z",
"items_total": "18.0",
"items_tax": "0.0",
"items_duty": null,
"subtotal": "18.0",
"total_tax": "0.0",
"grand_total": "18.0",
"total_quantity": 18,
"tax_level": "0.0",
"shipping_cost": "0.0",
"shipping_tax": "0.0",
"confirmed_at": "2026-08-10T06:08:51.000Z",
"due_date": null,
"in_warehouse_date": null,
"actual_in_warehouse_date": null,
"drop_id": null,
"notes": null,
"internal_notes": null,
"currency": "USD",
"company_id": 59575,
"company_name": "&CO WOMAN",
"season_id": 13043,
"organisation_id": 35802,
"status": "CONFIRMED",
"delivery_status": "Receiving",
"financial_status": "Not Paid",
"warehouses_ids": [
1623,
1627
],
"warehouses": [
"Primary warehouse",
"Main Outlet"
],
"payment_terms": "Payment due in 7 days",
"delivery_terms": null,
"line_items": [
{
"id": 148052,
"product_id": 136764,
"product_name": "Formal Shoe_1",
"product_identifier": "Formal shoe_1",
"variation_id": 290728,
"variation_identifier": "Formal shoe_1-BL",
"merch_hierarchy_path": "Shoes > Formals",
"color": "Black",
"code": "Black",
"unit_tax": "0.0",
"tax_level": "0.0",
"unit_price": "1.0",
"original_price": "1.0",
"warehouse_id": 1623,
"warehouse": "Primary warehouse",
"percentage_discount": "0.0",
"bundle_line_item": false,
"comments": "",
"product_brand": "Brand Twenty Five",
"country_of_origin": "IN",
"intrastat_code": "",
"product_cover_image": "https://qa-cdn.uphance.com/uploads/product/image/b2e82ec8ed6f0cdb/Brown.jpg",
"variation_images": [
"https://qa-cdn.uphance.com/uploads/product_image/image/8f389f6d14e8eca4/Black_9.jpeg"
],
"line_quantities": [
{
"id": 768572,
"size": "40",
"quantity": 6,
"sku_number": "FORMAL SHOE_1-B-40",
"sku_id": 1454196,
"size_desc": "40",
"size_desc_2": null,
"upc_number": "22337368",
"is_backorder": false,
"cancelled_qty": 0,
"received_qty": 6
},
{
"id": 768574,
"size": "42",
"quantity": 6,
"sku_number": "FORMAL SHOE_1-B-42",
"sku_id": 1454198,
"size_desc": "42",
"size_desc_2": null,
"upc_number": "22337382",
"is_backorder": false,
"cancelled_qty": 0,
"received_qty": 6
},
{
"id": 768576,
"size": "44",
"quantity": 6,
"sku_number": "FORMAL SHOE_1-B-44",
"sku_id": 1454200,
"size_desc": "44",
"size_desc_2": null,
"upc_number": "22337405",
"is_backorder": false,
"cancelled_qty": 0,
"received_qty": 6
}
]
}
]
},
{
"id": 26969,
"production_order_number": "1893",
"created_at": "2026-08-06T06:34:58.000Z",
"updated_at": "2026-08-06T09:00:58.000Z",
"items_total": "3401.5",
"items_tax": "0.0",
"items_duty": null,
"subtotal": "1.5",
"total_tax": "0.0",
"grand_total": "1.5",
"total_quantity": 3,
"tax_level": "0.0",
"shipping_cost": "0.0",
"shipping_tax": "0.0",
"confirmed_at": "2026-08-06T06:38:53.000Z",
"due_date": null,
"in_warehouse_date": null,
"actual_in_warehouse_date": null,
"drop_id": null,
"notes": null,
"internal_notes": null,
"currency": "USD",
"company_id": 59575,
"company_name": "&CO WOMAN",
"season_id": 13434,
"organisation_id": 35802,
"status": "CONFIRMED",
"delivery_status": "Receiving",
"financial_status": "Not Paid",
"warehouses_ids": [
1623
],
"warehouses": [
"Primary warehouse"
],
"payment_terms": "Payment due in 7 days",
"delivery_terms": null,
"line_items": [
{
"id": 148008,
"product_id": 149358,
"product_name": "MERCHONE",
"product_identifier": "mercshiwom78",
"variation_id": 316047,
"variation_identifier": "mercshiwom78-SNMRN",
"merch_hierarchy_path": "Shirts > womens123",
"color": "San Marino Prism",
"code": "SNMRN",
"unit_tax": "0.0",
"tax_level": "0.0",
"unit_price": "0.5",
"original_price": "0.5",
"warehouse_id": 1623,
"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": 768350,
"size": "14/32",
"quantity": 1,
"sku_number": "MERCSHIWOM78-SNMRN-101",
"sku_id": 1548172,
"size_desc": "14",
"size_desc_2": "32",
"upc_number": "",
"is_backorder": false,
"cancelled_qty": 0,
"received_qty": 0
},
{
"id": 768351,
"size": "14/33",
"quantity": 1,
"sku_number": "MERCSHIWOM78-SNMRN-105",
"sku_id": 1548173,
"size_desc": "14",
"size_desc_2": "33",
"upc_number": "",
"is_backorder": false,
"cancelled_qty": 0,
"received_qty": 0
},
{
"id": 768352,
"size": "14/34",
"quantity": 1,
"sku_number": "MERCSHIWOM78-SNMRN-109",
"sku_id": 1548174,
"size_desc": "14",
"size_desc_2": "34",
"upc_number": "",
"is_backorder": false,
"cancelled_qty": 0,
"received_qty": 0
}
]
}
]
}
],
"meta": {
"current_page": 1,
"next_page": 2,
"prev_page": null,
"total_pages": 2,
"total_count": 4
}
}
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
-H "Authorization: ACCESS_TOKEN"
Filter by warehouse
$ curl https://api.uphance.com/production_orders?by_warehouse=WAREHOUSE_ID
-H "Authorization: ACCESS_TOKEN"
Filter by manufacturer
$ curl https://api.uphance.com/production_orders?by_company=MANUFTURER_COMPANY_ID
-H "Authorization: ACCESS_TOKEN"
Filter by search query
$ curl https://api.uphance.com/production_orders?by_q=QUERY
-H "Authorization: ACCESS_TOKEN"
GET a production order
Retrieve a single production order by passing the order ID.
$ curl https://api.uphance.com/production_orders/[PRODUCTION_ORDER_ID]
-H "Authorization: ACCESS_TOKEN"
Example Response:
{
"production_order": {
"id": 26988,
"production_order_number": "1895",
"created_at": "2026-08-10T06:07:24.000Z",
"updated_at": "2026-08-10T06:12:48.000Z",
"items_total": "18.0",
"items_tax": "0.0",
"items_duty": null,
"subtotal": "18.0",
"total_tax": "0.0",
"grand_total": "18.0",
"total_quantity": 18,
"tax_level": "0.0",
"shipping_cost": "0.0",
"shipping_tax": "0.0",
"confirmed_at": "2026-08-10T06:08:51.000Z",
"due_date": null,
"in_warehouse_date": null,
"actual_in_warehouse_date": null,
"drop_id": null,
"notes": null,
"internal_notes": null,
"currency": "USD",
"company_id": 59575,
"company_name": "&CO WOMAN",
"season_id": 13043,
"organisation_id": 35802,
"status": "CONFIRMED",
"delivery_status": "Receiving",
"financial_status": "Not Paid",
"warehouses_ids": [
1623,
1627
],
"warehouses": [
"Primary warehouse",
"Main Outlet"
],
"payment_terms": "Payment due in 7 days",
"delivery_terms": null,
"production_address": {
"line_1": "350 Fifth Avenue, Apt 12B",
"line_2": "",
"line_3": "",
"city": "New York",
"state": "NY",
"country": "US",
"postcode": "10118"
},
"delivery_address": {
"line_1": "517 E 117th St",
"line_2": "",
"line_3": "",
"city": "New York",
"state": "NY",
"country": "US",
"postcode": "10035-4409"
},
"line_items": [
{
"id": 148052,
"product_id": 136764,
"product_name": "Formal Shoe_1",
"product_identifier": "Formal shoe_1",
"variation_id": 290728,
"variation_identifier": "Formal shoe_1-BL",
"merch_hierarchy_path": "Shoes > Formals",
"color": "Black",
"code": "Black",
"unit_tax": "0.0",
"tax_level": "0.0",
"unit_price": "1.0",
"original_price": "1.0",
"warehouse_id": 1623,
"warehouse": "Primary warehouse",
"percentage_discount": "0.0",
"bundle_line_item": false,
"comments": "",
"product_brand": "Brand Twenty Five",
"country_of_origin": "IN",
"intrastat_code": "",
"product_cover_image": "https://prod-cdn.uphance.com/uploads/product/image/b2e82ec8ed6f0cdb/Brown.jpg",
"variation_images": [
"https://prod-cdn.uphance.com/uploads/product_image/image/8f389f6d14e8eca4/Black_9.jpeg"
],
"line_quantities": [
{
"id": 768572,
"size": "40",
"quantity": 6,
"sku_number": "FORMAL SHOE_1-B-40",
"sku_id": 1454196,
"size_desc": "40",
"size_desc_2": null,
"upc_number": "22337368",
"is_backorder": false,
"cancelled_qty": 0,
"received_qty": 6
},
{
"id": 768574,
"size": "42",
"quantity": 6,
"sku_number": "FORMAL SHOE_1-B-42",
"sku_id": 1454198,
"size_desc": "42",
"size_desc_2": null,
"upc_number": "22337382",
"is_backorder": false,
"cancelled_qty": 0,
"received_qty": 6
},
{
"id": 768576,
"size": "44",
"quantity": 6,
"sku_number": "FORMAL SHOE_1-B-44",
"sku_id": 1454200,
"size_desc": "44",
"size_desc_2": null,
"upc_number": "22337405",
"is_backorder": false,
"cancelled_qty": 0,
"received_qty": 6
}
]
}
],
"custom_fields": [
{
"name": "Fuel Cost",
"field_type": "number",
"value": 0.0
},
{
"name": "Handling cost",
"field_type": "number",
"value": 0.0
}
],
"delivery_contact": {
"id": 56356,
"customer_id": 59402,
"first_name": "Andrew",
"last_name": "Rey",
"position": "",
"phone_1": "+12025550137",
"phone_2": "3432532424",
"email": "[email protected]",
"notes": "",
"buyer": false,
"shipping": false,
"billing": false
}
}
}
Retrieve a production order by passing the order number
$ curl https://api.uphance.com/production_orders?by_production_order_number=PRODUCTION_ORDER_NUMBER
-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",
"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"
}
]
}
}
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": 128
}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.