---
updatedAt: 2025-09-15T07:18:23.000Z
agentTools:
siteIndex: https://developer.jamf.com/llms.txt
projectIndex: https://developer.jamf.com/jamf-pro/v11.14.0/llms.txt
---
# Get the Cloud Distribution Point Inventory files details
Retrieves the details of the inventory files associated with a Cloud Distribution Point.This includes information about the files used for content distribution,
such as their type, status, and categorization.The response provides a comprehensive list of inventory files, which may include packages, ebooks, or mobile device apps,
allowing users to view the current state and metadata for each file in the distribution system.
# OpenAPI definition
```json
{
"openapi": "3.0.1",
"info": {
"title": "Jamf Pro API",
"termsOfService": "https://www.jamf.com/developer-resources/api-license-agreement",
"version": "11.14.0"
},
"servers": [
{
"url": "https://yourServer.jamfcloud.com/api"
}
],
"x-readme": {
"samples-languages": [
"curl",
"swift",
"ruby",
"python"
],
"explorer-enabled": false,
"proxy-enabled": true
},
"security": [
{
"Bearer": []
},
{
"ApiClient": []
},
{
"BasicAuth": [
"/v1/auth/token"
]
}
],
"paths": {
"/v1/cloud-distribution-point/inventory-files": {
"get": {
"tags": [
"cloud-distribution-point"
],
"summary": "Get the Cloud Distribution Point Inventory files details",
"description": "Retrieves the details of the inventory files associated with a Cloud Distribution Point.This includes information about the files used for content distribution,\nsuch as their type, status, and categorization.The response provides a comprehensive list of inventory files, which may include packages, ebooks, or mobile device apps,\nallowing users to view the current state and metadata for each file in the distribution system.\n",
"parameters": [
{
"$ref": "#/components/parameters/page"
},
{
"$ref": "#/components/parameters/page-size"
},
{
"name": "sort",
"in": "query",
"description": "Sorts results by one or more criteria, following the format property:asc/desc.
Default sort is filename:asc.
If using multiple criteria, separate with commas. Allows sort for id and name.",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "array",
"items": {
"type": "string"
},
"default": [
"filename.asc"
]
}
},
{
"name": "filter",
"in": "query",
"description": "Filters results. Use RSQL format for query. Allows for many fields, including filename, type etc.
Can be combined with paging and sorting.
Fields allowed in the query: filename
Default filter is an empty query and returns all results from the requested page.",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "string",
"default": ""
}
}
],
"responses": {
"200": {
"description": "Cloud Distribution Point Inventory objects has been fetched successfully.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CloudDistributionPointInventoryFilesResults"
}
}
}
},
"404": {
"description": "Cloud Distribution Point Inventory objects could not be found. The server either did not find a current representation for the requested resource or is trying to hide its existence from an unauthorized client.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiError"
}
}
}
}
},
"x-required-privileges": [
"Read Cloud Distribution Point"
]
}
}
},
"components": {
"schemas": {
"ApiError": {
"type": "object",
"properties": {
"httpStatus": {
"type": "integer",
"description": "HTTP status of the response",
"example": 400
},
"errors": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ApiErrorCause"
}
}
}
},
"ApiErrorCause": {
"required": [
"field"
],
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Error-specific code that can be used to identify localization string, etc.",
"example": "8675309"
},
"field": {
"type": "string",
"description": "Name of the field that caused the error.",
"example": "Name"
},
"description": {
"type": "string",
"description": "A general description of error for troubleshooting/debugging. Generally this text should not be displayed to a user; instead refer to errorCode and it's localized text",
"example": "I've just picked up a fault in the AE35 unit. It's going to go 100% failure in 72 hours"
},
"id": {
"type": "string",
"description": "id of object with error. Optional.",
"nullable": true,
"example": "3"
}
}
},
"CloudDistributionPointInventoryFiles": {
"required": [
"fileObjectId",
"filename",
"status",
"type"
],
"type": "object",
"properties": {
"inventoryId": {
"type": "string",
"description": "A unique identifier for the cloud distribution point inventory file.This ID is used to reference a specific inventory resource within the system.",
"readOnly": true,
"example": "1,"
},
"type": {
"type": "string",
"description": "The type of the inventory file. This field indicates whether the file is related to a package, mobile device app, or an ebook.",
"example": "PACKAGE",
"enum": [
"PACKAGE",
"MOBILE_DEVICE_APP",
"EBOOK"
]
},
"filename": {
"type": "string",
"description": "The name of the inventory file. This could be the name of a package, a mobile device app, or an ebook file, depending on the file type. The name should match the actual file or package name as stored in the cloud distribution system.",
"example": "SettingPackage"
},
"fileObjectId": {
"type": "string",
"description": "A unique identifier for each file type (package, ebook, or mobile device app). This ID is used to construct the URL for accessing or navigating to the specific resource related to the file type.",
"example": "1"
},
"category": {
"type": "string",
"description": "The category assigned to the inventory file (package, ebook, or mobile device app) during creation. This helps group and organize files based on their type or purpose, such as security software or productivity tools.",
"example": "Category1"
},
"status": {
"type": "string",
"description": "The current status of the inventory file, indicating the progress or outcome of the file's upload process.It reflects whether the file is ready for use, still being processed, or has encountered an error.",
"example": "READY",
"enum": [
"READY",
"PENDING",
"ERROR"
]
}
}
},
"CloudDistributionPointInventoryFilesResults": {
"required": [
"totalCount"
],
"type": "object",
"properties": {
"totalCount": {
"type": "integer",
"example": 1
},
"results": {
"minItems": 0,
"type": "array",
"items": {
"$ref": "#/components/schemas/CloudDistributionPointInventoryFiles"
}
}
}
}
},
"parameters": {
"page": {
"name": "page",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "integer",
"default": 0
}
},
"page-size": {
"name": "page-size",
"in": "query",
"required": false,
"style": "form",
"explode": true,
"schema": {
"type": "integer",
"default": 100
}
}
},
"securitySchemes": {
"Bearer": {
"type": "http",
"scheme": "bearer",
"bearerFormat": "JWT"
},
"BasicAuth": {
"type": "http",
"description": "Basic auth is used only for obtaining bearer tokens from the /v1/auth/token endpoint",
"scheme": "basic"
},
"ApiClient": {
"type": "oauth2",
"description": "Jamf Pro API Roles and Clients provide a client ID and secret for obtaining access tokens using the OAuth2 client_credentials grant type",
"flows": {
"clientCredentials": {
"tokenUrl": "/api/v1/oauth/token",
"scopes": {}
}
}
}
}
},
"x-si-base": "swagger.json",
"x-github-repo": "jamf/Jamf-Pro-API-Schema",
"x-github-sha": "5f8b85a61ce288205f7b44d478a117fb1acea0c6"
}
```