Retrieve Production Orders
GET
production-orders
Retrieves a paginated list of all Production Orders, optionally filtered and sorted. When additional results are available, the pagination object in the response payload provides a “nextUrl” that links to the next page of results.
Resource Information
| Method and URI | GET https://api.aps.autodesk.com/fusion-operations/v2/production-orders |
| Authentication Context | No security required |
| Required OAuth Scopes | data:read data:write |
| Data Format | JSON |
Request
Headers
| Authorization* string | JWT Access Token |
* Required
Request
Query String Parameters
| filter[id] int | Filter Production Orders matching the specified id. |
| filter[code] string | Filter Production Orders by code. Pass the value as URL‑encoded. |
| filter[status] enum:string | Filter Production Orders by status. When OPEN, returns open Production Orders; when CLOSED, returns closed Production Orders; when ARCHIVED, returns archived Production Orders. If not provided, returns open Production Orders. Accepts multiple values.
Possible values: OPEN, CLOSED, ARCHIVED |
| filter[active] boolean | Filters active Production Orders in the tablet. When true, it returns active Production Orders; when false, it returns inactive Production Orders; when null, it returns all Production Orders. |
| filter[started] boolean | Filters already started Production Orders. When true, it returns already started Production Orders; when false, it returns not started Production Orders; when null, it returns all Production Orders. |
| filter[startDate] string | Filter Production Orders by startDate. Accepts an ISO-8601 date time or an inclusive date time range in the format lowerValue..upperValue, lowerValue.., or ..upperValue. Returns Production Orders started within the specified range. |
| filter[dueDate] string | Filter Production Orders by due date time. Accepts an ISO-8601 date time or an inclusive date time range in the format lowerValue..upperValue, lowerValue.., or ..upperValue. Returns Production Orders with due dates within the specified date time or range. |
| filter[shipping.id] int | Filter Production Orders by shipping id. |
| filter[shipping.code] string | Filter Production Orders by shipping code. Pass the value as URL‑encoded. |
| filter[salesOrder.id] int | Filter Production Orders by Sales Order id. |
| filter[salesOrder.code] string | Filter Production Orders by Sales Order code. Pass the value as URL‑encoded. |
| filter[product.id] int | Filter Production Orders containing the Product id. |
| filter[product.code] string | Filter Production Orders containing the Product code. Pass the value as URL‑encoded. |
| filter[productFamily.id] int | Filter Production Orders containing a Product of the Product Family id. |
| filter[productFamily.code] string | Filter Production Orders containing a Product of the Product Family code. Pass the value as URL‑encoded. |
| filter[section.id] int | Filter Production Orders containing a Products of the section id. |
| filter[section.name] string | Filter Production Orders containing Products of the section name. Pass the value as URL‑encoded. |
| filter[worker.id] int | Filter Production Orders assigned to the worker id. |
| filter[worker.number] int | Filter Production Orders assigned to the worker number. |
| filter[workerGroup.id] int | Filter Production Orders assigned to the worker group id. |
| filter[workerGroup.name] string | Filter Production Orders assigned to the worker group name. Pass the value as URL‑encoded. |
| filter[machine.id] int | Filter Production Orders assigned to the machine id. |
| filter[machine.code] string | Filter Production Orders assigned to the machine code. Pass the value as URL‑encoded. |
| limit int | Maximum number of results returned. Defaults to 25. |
| offset int | Page offset. Default value is 0. |
| sort string | Comma separated fields to sort items by. Fields: id, code, startDate, dueDate. Default: “startDate desc”. |
Response
HTTP Status Code Summary
| 200 OK | A list of Production Orders. |
| 400 Bad Request | Bad request due to invalid data. |
| 401 Unauthorized | The access token is invalid. It may have either expired or may not be a three-legged access token. Please verify the token and retry the request. |
| 403 Forbidden | The request was successfully validated but lacked required permission. Please verify your token permissions and retry the request. |
| 429 Too Many Requests | Rate limit exceeded; wait some time before retrying. |
| 500 Internal Server Error | An unknown server-side error occurred. Please try again later. If the problem persists, please contact support. |
Response
Header (429)
| Retry-After integer | The number of seconds to wait before retrying the request. |
Response
Body Structure (200)
Expand all
| results array: object | List of Production Orders |
| id int | Unique identifier of the Production Order. |
| code string | Production Order code
Max length: 255 |
| startDate datetime: ISO 8601 | Start date of the Production Order (e.g. 2025-06-21T14:07:17Z) |
| dueDate datetime: ISO 8601 | Due date of the Production Order (e.g. 2025-06-21T14:07:17Z) |
| predictedDuration string | Customer Time (ISO 8601 duration, e.g. PT3H15M30S). It will be added to the start time if the due date is not provided. |
| products array: object | |
| id int | Unique identifier of the Production Order product entry. |
| product | |
| id int | Unique identifier of the referenced entity. |
| code string | Code of the referenced entity.
Max length: 255 |
| name string | Name of the referenced entity.
Max length: 255 |
| anyOf | |
| 0 | |
| 1 | |
| quantityOrdered number | |
| lot string | Lot identifier associated with the product entry.
Max length: 255 |
| observations string | Additional notes or observations for the product entry.
Max length: 2000 |
| variableParameters array: object | |
| name string | |
| value string | |
| description string | Max length: 255 |
| workerGroups array: object | |
| id int | Unique identifier of the referenced entity. |
| name string | Name of the referenced entity.
Max length: 255 |
| anyOf | |
| 0 | |
| 1 | |
| active boolean | Indicates if the Production Order is visible in the tablet |
| workers array: object | |
| id int | |
| number int | |
| name string | Max length: 255 |
| anyOf | |
| 0 | |
| 1 | |
| machines array: object | |
| id int | Unique identifier of the referenced entity. |
| code string | Code of the referenced entity.
Max length: 255 |
| name string | Name of the referenced entity.
Max length: 255 |
| anyOf | |
| 0 | |
| 1 | |
| shipping | |
| id int | Unique identifier of the referenced entity. |
| code string | Code of the referenced entity.
Max length: 255 |
| anyOf | |
| 0 | |
| 1 | |
| site | Site associated with the Production Order. |
| id int | Unique identifier of the referenced entity. |
| code string | Code of the referenced entity.
Max length: 255 |
| anyOf | Site associated with the Production Order. |
| 0 | |
| 1 | |
| boxQuantity int | |
| notes string | Max length: 5000 |
| status enum:string | Possible values: OPEN, CLOSED, ARCHIVED |
| parameters array: object | |
| name string | |
| value string | |
| pagination object | |
| limit int | Maximum number of results returned in this page. |
| offset int | Number of results skipped before this page. |
| nextUrl string | URL for the next page of results. Null when there are no additional pages. |
Example
A list of Production Orders.
Request
curl -v 'https://developer.api.autodesk.com/fusion-operations/v2/production-orders' \
-H 'Authorization: '
Response
{
"results": [
{
"id": 382,
"code": "PO-1001",
"startDate": "2024-04-01T10:00:00Z",
"dueDate": "2024-04-15T10:00:00Z",
"predictedDuration": "PT1H40M00S",
"products": [
{
"id": 78,
"product": {
"id": 45,
"code": "ProductX",
"name": "Product X 100"
},
"quantityOrdered": 1,
"lot": "LOT12345",
"observations": null,
"variableParameters": [
{
"name": "Color",
"value": "Red"
},
{
"name": "Size",
"value": "Medium"
}
]
}
],
"description": "Production Order for Product X",
"workerGroups": [
{
"id": 5,
"name": "Worker Group 1"
}
],
"active": true,
"assignedWorkers": [
{
"id": 20,
"name": "Worker 200",
"number": 43
}
],
"machines": [
{
"id": 10,
"code": "MC-100",
"name": "Machine 100"
}
],
"shipping": {
"id": 451,
"code": "Shipping001"
},
"site": {
"id": 12,
"code": "SITE-01"
},
"boxQuantity": 4,
"notes": "Ensure quality checks are performed.",
"status": "OPEN",
"parameters": [
{
"name": "Voltage",
"value": "220V"
}
]
},
{
"id": 386,
"code": "PO-1002",
"startDate": "2025-04-01T10:00:00Z",
"dueDate": "2025-04-15T10:00:00Z",
"predictedDuration": null,
"products": [
{
"id": 90,
"product": {
"id": 50,
"code": "ProductY",
"name": "Product Y 65"
},
"quantityOrdered": 50,
"lot": null,
"observations": null,
"variableParameters": []
}
],
"description": "Production Order for Product Y",
"workerGroups": [],
"active": true,
"assignedWorkers": [
{
"id": 20,
"name": "Worker 200",
"number": 43
}
],
"machines": [],
"shipping": {
"id": 451,
"code": "Shipping001"
},
"boxQuantity": null,
"notes": "Ensure quality checks are performed.",
"status": "OPEN",
"parameters": []
}
],
"pagination": {
"limit": 20,
"offset": 0,
"nextUrl": null
}
}
Show More