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