Retrieve files attached to a Sales Order
GET
sales-orders/{salesOrderId}/files
Retrieves a list of files attached to the specified Sales Order. When additional results are available, the pagination object in the response 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/sales-orders/{salesOrderId}/files |
| Authentication Context | No security required |
| Required OAuth Scopes | data:read data:write |
| Data Format | JSON |
Request
Headers
| Authorization* string | JWT Access Token |
* Required
Request
URI Parameters
| salesOrderId int | Unique identifier of the Sales Order. |
Request
Query String Parameters
| filter[id] int | Filter Files of the specified Sales Order matching the specified id. |
| filter[showOnTablet] boolean | Filter files by whether they are shown on the tablet. |
| sort string | Comma-separated field and direction to sort files by. Sortable fields: id, name, createdAt, size. Default: “createdAt desc”. |
| limit int | Maximum number of results returned. Defaults to 25. |
| offset int | Number of results to skip. Default value is 0. |
Response
HTTP Status Code Summary
| 200 OK | A list of files attached to the Sales Order. |
| 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. |
| 404 Not Found | The resource in the path does not exist. |
| 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 files attached to the Sales Order |
| id int | Unique identifier of the file. |
| name string | Max length: 255 |
| createdAt datetime: ISO 8601 | Creation date of the file (e.g. 2025-06-21T15:07:17Z) |
| size int | Size of the file in KiB (kibibytes) |
| showOnTablet boolean | Indicates if the file should be shown in the tablet |
| 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 files attached to the Sales Order.
Request
curl -v 'https://developer.api.autodesk.com/fusion-operations/v2/sales-orders/:salesOrderId/files' \
-H 'Authorization: '
Response
{
"results": [
{
"id": 101,
"name": "specification.pdf",
"createdAt": "2024-04-02T15:30:00Z",
"size": 128,
"showOnTablet": false
},
{
"id": 102,
"name": "design.png",
"createdAt": "2025-04-02T15:30:00Z",
"size": 256,
"showOnTablet": true
}
],
"pagination": {
"limit": 20,
"offset": 0,
"nextUrl": null
}
}
Show More