Request

Response

    Retrieve Inventory Movements
    GET

    inventory-movements

    Retrieves a paginated list of all Inventory Movements, 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/inventory-movements
    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 Inventory Movements matching the specified id.
    filter[date]
    string
    Filter Inventory Movements by date and time. Accepts an ISO-8601 date time or an inclusive date time range in the format lowerValue..upperValue, lowerValue.., or ..upperValue. Returns Inventory Movements created within the specified date time or range.
    filter[product.id]
    int
    Filter Inventory Movements by Product, providing the id.
    filter[product.code]
    string
    Filter Inventory Movements by Product, providing the code. Pass the value as URL‑encoded.
    filter[worker.id]
    int
    Filter Inventory Movements by worker, providing the id.
    filter[worker.number]
    int
    Filter Inventory Movements by worker, providing the number.
    filter[shipping.id]
    int
    Filter Inventory Movements by shipping, providing the id.
    filter[receiving.id]
    int
    Filter Inventory Movements by receiving, providing the id.
    filter[production.id]
    int
    Filter Inventory Movements by Production, providing the id.
    filter[maintenanceOrder.id]
    int
    Filter Inventory Movements by Maintenance Order, providing the id.
    filter[maintenanceOrder.code]
    string
    Filter Inventory Movements by Maintenance Order, providing the code. Pass the value as URL‑encoded.
    filter[purchaseOrder.id]
    int
    Filter Inventory Movements by Purchase Order, providing the id.
    filter[purchaseOrder.code]
    string
    Filter Inventory Movements by Purchase Order, providing the code. Pass the value as URL‑encoded.
    filter[productFamily.id]
    int
    Filter Inventory Movements with the Product belonging to the Product Family, providing the id.
    filter[productFamily.code]
    string
    Filter Inventory Movements with the Product belonging to the Product Family, providing the code. Pass the value as URL‑encoded.
    filter[lot.id]
    int
    Filter Inventory Movements by Lot, providing the id.
    filter[lot.code]
    string
    Filter Inventory Movements by Lot, providing the code. Pass the value as URL‑encoded.
    filter[quantity]
    string
    Filter Inventory Movements by quantity. Accepts a range in the format lowerValue..upperValue, lowerValue.., or ..upperValue. Returns Inventory Movements with quantity within the specified range.
    filter[type]
    array: string
    Filter Inventory Movements by input/output types. Accepts a comma-separated list of values.
    filter[internal]
    boolean
    When set to true, only Inventory Movements marked as internal are returned. When set to false, Inventory Movements marked as internal are excluded. When nothing is sent, return all Inventory Movements.
    offset
    int
    Page offset. Default value is 0.
    limit
    int
    Maximum number of results returned. Defaults to 25.
    sort
    string
    Comma separated fields to sort items by. Fields: id, date. Default: “date desc”.

    Response

    HTTP Status Code Summary

    200
    OK
    A list of Inventory Movements.
    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 Inventory Movements
    id
    int
    Unique identifier of the inventory movement.
    date
    datetime: ISO 8601
    Date of the inventory movement (e.g. 2025-06-21T14:07:17Z)
    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
    quantity
    number
    The quantity of the Product moved
    unitOfMeasurement
    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
    receiving
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code 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
    production
    object
    id
    int
    Unique identifier of the Production linked to the inventory movement. Applies only for consumptions and produced materials during Production.
    maintenanceOrder
    object
    id
    int
    Unique identifier of the Maintenance Order linked to the inventory movement. Applies only for consumptions in Maintenance Orders.
    type
    string
    Type of inventory movement. PRODUCTION and CONSUMPTION stock movements cannot be created. They are automatically created in the Production endpoints. The TRANSIT type cannot be used to create inventory movements.
    lot
    id
    int
    Unique identifier of the lot.
    code
    string
    Max length: 255
    expirationDate
    string
    Expiration date of the lot (e.g. 2025-06-21)
    supplierLot
    string
    Max length: 255
    anyOf
    0
    1
    warehouseLocation
    Warehouse location associated with the inventory movement. If null the Production warehouse is considered
    anyOf
    Warehouse location associated with the inventory movement. If null the Production warehouse is considered
    0
    object
    1
    all of
    0
    all of
    0
    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
    1
    all of
    0
    object
    id
    int
    Unique identifier of the warehouse.
    code
    string
    Max length: 255
    name
    string
    Max length: 255
    site
    all of
    Site associated with the Inventory Movement.
    0
    all of
    0
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    anyOf
    0
    1
    comment
    string
    Max length: 255
    cost
    number
    worker
    id
    int
    number
    int
    name
    string
    Max length: 255
    anyOf
    0
    1
    site
    Site associated with the Inventory Movement.
    anyOf
    Site associated with the Inventory Movement.
    0
    object
    1
    all of
    0
    all of
    0
    id
    int
    Unique identifier of the referenced entity.
    code
    string
    Code of the referenced entity.

    Max length: 255

    anyOf
    0
    1
    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 Inventory Movements.

    Request

    curl -v 'https://developer.api.autodesk.com/fusion-operations/v2/inventory-movements' \
      -H 'Authorization: '
    

    Response

    {
      "results": [
        {
          "id": 382,
          "date": "2024-04-27T10:00:00Z",
          "product": {
            "id": 21,
            "code": "ProductA",
            "name": "Product A 204"
          },
          "quantity": 100,
          "unitOfMeasurement": {
            "id": 3,
            "code": "pcs",
            "name": "Pieces"
          },
          "type": "RECEIVING",
          "cost": 2500.0,
          "worker": {
            "id": 12,
            "number": 66,
            "name": "Peter"
          },
          "comment": "My wonderful inventory Movement note with less than 255 characters",
          "warehouseLocation": {
            "id": 5,
            "code": "Shelf 123",
            "name": "Shelf 123 - at Main Warehouse",
            "warehouse": {
              "id": 2,
              "code": "Main Warehouse",
              "name": "Main Warehouse"
            }
          },
          "lot": {
            "id": 5,
            "code": "Lot12345"
          },
          "site": {
            "id": 12,
            "code": "SITE-01"
          }
        },
        {
          "id": 385,
          "date": "2024-04-27T10:00:00Z",
          "product": {
            "id": 21,
            "code": "ProductA",
            "name": "Product A 204"
          },
          "quantity": 100,
          "unitOfMeasurement": {
            "id": 3,
            "code": "pcs",
            "name": "Pieces"
          },
          "type": "RECEIVING",
          "cost": 200.0,
          "worker": {
            "id": 12,
            "number": 66,
            "name": "Peter"
          },
          "comment": "My wonderful inventory Movement note with less than 255 characters",
          "warehouseLocation": null,
          "lot": {
            "id": 5,
            "code": "Lot1234",
            "product": {
              "id": 21,
              "code": "ProductA",
              "name": "Product A 204"
            },
            "site": null
          }
        }
      ],
      "pagination": {
        "limit": 20,
        "offset": 0,
        "nextUrl": null
      }
    }
    
    Show More