# Get Product Downloadables ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/products/{product-id}/downloadables/: get: summary: Get Product Downloadables deprecated: false description: >- This endpoint retrieves a list of downloadable files associated with a specific product, providing details about each downloadable file, including access URLs, display names, and status. The response includes pagination information and metadata about the files, allowing the client to manage multiple files for a product. `products.read` - Products Read tags: - Default module/Apps/Merchant APIs/Products/Digital Products parameters: - name: product-id in: path description: '' required: true example: a7ad89d0-03e2-430f-b6e4-0624ef05e571 schema: type: string - name: Authorization in: header description: >- The Authorization token is a unique key given to the third-party application (Partner) by Zid. It is used to authenticate the API requests made by the Partner application. The token verifies the partner's identity and ensures they have permission to access Zid's API but does not provide any specific user or store information. It should be included in the header of API requests when the partner application needs to access Zid's API. required: true example: '{{Autherization}}' schema: type: string - name: Store-Id in: header description: Unique identifier of the store. required: false example: 3 schema: type: integer - name: Accept-Language in: header description: >- Preferred language for the response. Defaults to `en` if not specified. required: false example: en schema: type: string - name: X-manager-Token in: header description: >- This token is used to authenticate and access information related to the store. It is obtained through an OAuth mechanism and is required to perform operations on the store's data. The `X-Manager-Token` should be included in the header of API requests that require store-related information. required: false example: '{{Access-Token}}' schema: type: string - name: Role in: header description: Role of the user. required: false example: Manager schema: type: string - name: Currency in: header description: >- The currency in which the data should be returned. This should be provided as an ISO 4217 currency code. For example, SAR for Saudi Riyal, USD for United States Dollar, KWD for Kuwaiti Dinar, etc. required: false example: SAR schema: type: string responses: '200': description: '' content: application/json: schema: type: object properties: count: type: integer description: >- The total number of downloadable files available for the product. examples: - 2 next: type: 'null' description: >- URL to the next page of results, or null if there are no additional pages. previous: type: 'null' description: >- URL to the previous page of results, or null if there are no previous pages. results: type: array items: type: object properties: id: type: string description: Unique identifier for the downloadable file. examples: - f2f3ff33-a68e-498a-a052-0ea1bbddc144 product_id: type: string description: >- The ID of the product linked to the downloadable file. examples: - 5af835b7-1a37-4401-a3fc-6d9007c44c8f file: type: object properties: url: type: string description: >- Direct access URL for the file. For external files, this is the external URL; for internal files, it includes authentication parameters if required. examples: - >- https://www.editage.com/info/file/most-common-reasons-for-journal-rejections.pdf key: type: string description: >- Storage key for the file within internal storage, present only for internal files. examples: - >- 9fc92996-ffbe-4bca-9b8e-6682137fe7b6/product-downloadables/8244389b-8fe3-47dc-85ae-2f8e9e95f899 meta: type: object properties: content_length: type: integer description: File size in bytes. examples: - 278103 content_type: type: string description: The MIME type of the file. examples: - binary/octet-stream content_encoding: type: 'null' description: >- Encoding applied to the file, or null if none. required: - content_length - content_type - content_encoding x-apidog-orders: - content_length - content_type - content_encoding description: Metadata for the file (only for internal files). x-apidog-ignore-properties: [] required: - url - key - meta x-apidog-orders: - url - key - meta description: Provides access and metadata details for the file. x-apidog-ignore-properties: [] display_name: type: string description: The user-friendly name of the file for display. examples: - most-common-reasons-for-journal-rejections display_order: type: 'null' description: >- Optional ordering value to specify the display sequence among files. is_enabled: type: boolean description: Indicates if the file is available for download. default: true is_external: type: boolean description: >- Defines if the file is hosted externally or within the primary storage system. default: true required: - id - product_id - file - display_name - display_order - is_enabled - is_external x-apidog-orders: - id - product_id - file - display_name - display_order - is_enabled - is_external x-apidog-ignore-properties: [] description: A list of downloadable file details. required: - count - next - previous - results x-apidog-orders: - count - next - previous - results x-apidog-ignore-properties: [] headers: {} x-apidog-name: OK '400': description: '' content: application/json: schema: type: array items: type: string example: - Product is not of type downloadable headers: {} x-apidog-name: Bad Request '401': description: '' content: application/json: schema: type: object description: >- Response returned when the request cannot be authenticated because the required credentials are missing, invalid, or expired. properties: status: type: string description: Indicates the overall status of the API response. examples: - error message: type: object description: >- Contains structured details explaining why the request could not be authenticated. properties: type: type: string description: Indicates the category of the response message. examples: - error code: type: string description: >- A machine-readable code identifying the authentication error. Returns null when no specific code is available. examples: - UNAUTHORIZED nullable: true name: type: string description: >- A short, human-readable title describing the authentication error. Returns null when no title is available. examples: - Unauthorized nullable: true description: type: string description: >- A human-readable explanation of why the request could not be authenticated. Returns null when no detailed explanation is available. examples: - >- Authentication credentials are missing, invalid, or expired. nullable: true required: - type - code - name - description x-apidog-orders: - type - code - name - description x-apidog-ignore-properties: [] required: - status - message x-apidog-orders: - status - message examples: - status: error message: type: error code: UNAUTHORIZED name: Unauthorized description: >- Authentication credentials are missing, invalid, or expired. x-apidog-ignore-properties: [] examples: '2': summary: Example 1 value: status: error message: type: error code: ERROR_SESSION_MISSING name: Sorry description: Please login first. '3': summary: Example 2 value: status: error message: type: error code: ERROR_SESSION_INVALID name: Sorry description: Login session expired. Please login again. '4': summary: Example 3 value: status: error message: type: error code: ERROR_SESSION_INVALID name: Sorry description: Invalid authentication headers: {} x-apidog-name: Unauthorized '500': description: '' content: application/json: schema: type: object properties: status: type: string description: Status of the error. message: $ref: '#/components/schemas/ResponseEnvelopMessage' required: - status - message x-apidog-orders: - status - message x-apidog-ignore-properties: [] example: status: error message: type: error code: MSG_HIDDEN name: Error description: Internal Server Error headers: {} x-apidog-name: Internal Server error security: [] x-apidog-folder: Default module/Apps/Merchant APIs/Products/Digital Products x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/613905/apis/api-11448025-run components: schemas: ResponseEnvelopMessage: type: object properties: type: type: string description: Type of response message returned by the API. examples: - success code: type: string description: Response code returned by the API, if available. examples: - MSG_POPUP_OK nullable: true name: type: string description: Name or title of the response message, if available. examples: - Coupons nullable: true description: type: string description: Detailed description of the response message, if available. examples: - Coupons created successfully nullable: true required: - type - code - name - description description: Additional response metadata. x-apidog-orders: - type - code - name - description x-apidog-ignore-properties: [] x-apidog-folder: '' securitySchemes: {} servers: - url: https://api.zid.sa/ description: Prod Env security: [] ```