Request

Response

    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