Skip to main content

Fetch product documents

Retrieve downloadable documents (PDFs, datasheets, manuals) attached to a product.

Query​

query GetProductDocuments($productId: Int!) {
  product(productId: $productId) {
    productId
    media {
      documents {
        items {
          id
          type
          priority
          alt(language: "NL") { language value }
          description(language: "NL") { language value }
          documents {
            language
            originalUrl
            mimeType
          }
        }
        itemsFound
      }
    }
  }
}

Variables​

{
  "productId": 25
}

Response​

{
  "data": {
    "product": {
      "productId": 25,
      "media": {
        "documents": {
          "items": [
            {
              "id": "c277d06a-5bed-4bd6-809b-d833387447cc",
              "type": "DOCUMENT",
              "priority": 1000,
              "alt": [{ "language": "NL", "value": "Brochure-Dovre-Saga-.pdf" }],
              "description": [{ "language": "NL", "value": "Brochure-Dovre-Saga-.pdf" }],
              "documents": [
                {
                  "language": "en",
                  "originalUrl": "https://media.helice.cloud/newbo.helice.cloud/documents/en/c277d06a-5bed-4bd6-809b-d833387447cc-Brochure-Dovre-Saga-.pdf",
                  "mimeType": "application/pdf"
                }
              ]
            },
            {
              "id": "44225fc6-3dae-439a-86e8-35480163aa51",
              "type": "DOCUMENT",
              "priority": 1000,
              "alt": [{ "language": "NL", "value": "Installatievoorschriften.pdf" }],
              "description": [{ "language": "NL", "value": "Installatievoorschriften.pdf" }],
              "documents": [
                {
                  "language": "en",
                  "originalUrl": "https://media.helice.cloud/newbo.helice.cloud/documents/en/44225fc6-3dae-439a-86e8-35480163aa51-Installatievoorschriften.pdf",
                  "mimeType": "application/pdf"
                }
              ]
            }
          ],
          "itemsFound": 2
        }
      }
    }
  }
}

How it works​

Each MediaDocument item contains a nested documents array with the actual file URLs per language. Use originalUrl to link to the downloadable file. The description and alt fields provide display names — pass a language argument to filter them. The mimeType tells you the file format (e.g., application/pdf). Sort by priority for display order (lower values appear first). The documents response is paginated — pass a search argument with page and offset if the product has many documents.

See also​