---
title: "Returns a paged list of chemicals declarations and provides search functionality."
url: "https://developer-qual.migros.ch/apis/quality-data-8/versions/aa2147b3-5aa1-4f7f-a449-bd7dc3796d65/operations/get-chemical-declarations"
---

> Full API specification: https://developer-qual.migros.ch/apis/quality-data-8/versions/aa2147b3-5aa1-4f7f-a449-bd7dc3796d65.md

# Returns a paged list of chemicals declarations and provides search functionality.

`GET` `/migros/products/v8/products/chemicals-declarations`

Operation ID: `get-chemical-declarations`

Returns a paged list of chemicals declarations and provides search functionality.

## Query parameters

- `limit` (integer, optional) - Maximum number of results (max 2000).
- `offset` (integer, optional) - Result set offset.
- `lang` (string, optional) - Defines the language (de/fr/it/en) for this request as query parameter. Either use the query param "lang" or header "Accept-Language", not both.
- `product_ids` (string, optional) - A comma separated list or an array of product ids to filter the declarations.
- `updated_since` (string, optional) - The date and time used to only get declarations updated since a certain timestamp. The format is according to ISO 8601 and can include a time zone offset, e.g. 2018-01-01T06:00:00+01:00 (careful about the plus getting properly percent-encoded when passed). Default time zone is Swiss time.

## Header parameters

- `Accept-Language` (string, optional) - Defines the language (de/fr/it/en) for this request as request header. Either use the query param "lang" or header "Accept-Language", not both.

## Responses

- `200` - Returned when successful
- `400` - If the request parameters are invalid.

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Quality Data
  version: "8"
servers:
  - description: Public Kong Gateway URL
    url: https://api-qual.migros.ch
paths:
  /migros/products/v8/products/chemicals-declarations:
    get:
      description: Returns a paged list of chemicals declarations and provides search
        functionality.
      operationId: get-chemical-declarations
      parameters:
        - $ref: "#/components/parameters/limit"
        - $ref: "#/components/parameters/offset"
        - $ref: "#/components/parameters/lang"
        - $ref: "#/components/parameters/Accept-Language"
        - description: A comma separated list or an array of product ids to filter the
            declarations.
          in: query
          name: product_ids
          schema:
            type: string
        - description: The date and time used to only get declarations updated since a
            certain timestamp. The format is according to ISO 8601 and can
            include a time zone offset, e.g. 2018-01-01T06:00:00+01:00 (careful
            about the plus getting properly percent-encoded when passed).
            Default time zone is Swiss time.
          in: query
          name: updated_since
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ChemicalsDeclarationCollection"
          description: Returned when successful
        "400":
          $ref: "#/components/responses/400"
      summary: Returns a paged list of chemicals declarations and provides search
        functionality.
      tags:
        - Chemicals Declarations
security:
  - Kong-Api-Key: []
  - basicAuth: []
components:
  parameters:
    limit:
      description: Maximum number of results (max 2000).
      in: query
      name: limit
      required: false
      schema:
        default: 10
        maximum: 2000
        minimum: 0
        type: integer
    offset:
      description: Result set offset.
      in: query
      name: offset
      required: false
      schema:
        default: 0
        minimum: 0
        type: integer
    lang:
      description: Defines the language (de/fr/it/en) for this request as query
        parameter. Either use the query param "lang" or header
        "Accept-Language", not both.
      in: query
      name: lang
      schema:
        default: de
        enum:
          - de
          - fr
          - it
          - en
        type: string
    Accept-Language:
      description: Defines the language (de/fr/it/en) for this request as request
        header. Either use the query param "lang" or header "Accept-Language",
        not both.
      in: header
      name: Accept-Language
      schema:
        default: de
        enum:
          - de
          - fr
          - it
          - en
        type: string
  schemas:
    ChemicalsDeclarationCollection:
      description: A collection of chemicals declaration instances.
      properties:
        chemicals_declarations:
          items:
            $ref: "#/components/schemas/ChemicalsDeclaration"
          type: array
        total_hits:
          description: >-
            The total hits may exceed the actual count of results in the
            collection.


            It represents the total number of results of a search and not only
            the

            potentially paginated subset.
          nullable: true
          type: integer
      required:
        - chemicals_declarations
        - total_hits
      type: object
    ChemicalsDeclaration:
      properties:
        biozid_number_ch:
          description: "PIM: biozidNummerCh."
          nullable: true
          type: string
        chem_voc_concentration:
          description: Concentration of chemical volatile organic compounds, in percent.
          format: float
          nullable: true
          type: number
        chemical_quantity_limit:
          description: |-
            Amount that gets dangerous, for risk analysis.

            PIM: chemMengenSchwelle
          nullable: true
          type: integer
        childproof_closure:
          nullable: true
          type: boolean
        classification_ghs_class:
          description: New GHS standard statements.
          items:
            $ref: "#/components/schemas/ChemicalsStatement"
          nullable: true
          type: array
        cleaning_agents:
          description: "PIM: reinigungsinhaltsstoffe."
          items:
            $ref: "#/components/schemas/ChemicalsCleaningAgent"
          nullable: true
          type: array
        container_content:
          properties:
            Unit:
              nullable: true
              type: string
            Value:
              nullable: true
              type: integer
          type: object
        contains_nanomaterial:
          nullable: true
          type: boolean
        cpid_number:
          nullable: true
          type: string
        dangerous_goods_by_transport_regulations:
          nullable: true
          type: boolean
        declaration_number:
          type: string
        declaration_required_ingredients:
          description: "PIM: deklarationspflichtigeStoffe."
          items:
            $ref: "#/components/schemas/ChemicalsMaterial"
          nullable: true
          type: array
        documents:
          items:
            $ref: "#/components/schemas/Document"
          type: array
        eu_hazard_statements:
          description: New GHS european union extra hazard statements.
          items:
            $ref: "#/components/schemas/ChemicalsStatement"
          nullable: true
          type: array
        extra_cleaning_agents:
          description: "PIM: weitereReinigungsInhaltsstoffe."
          items:
            $ref: "#/components/schemas/ChemicalsCleaningAgent"
          nullable: true
          type: array
        extra_hazard_statements:
          description: "PIM: besondereGefahrenSaetze."
          items:
            $ref: "#/components/schemas/ChemicalsStatement"
          nullable: true
          type: array
        hazard_classes:
          description: "PIM: gefahrenGutKlassen."
          items:
            $ref: "#/components/schemas/ChemicalsStatement"
          nullable: true
          type: array
        hazard_pictograms:
          items:
            $ref: "#/components/schemas/Image"
          nullable: true
          type: array
        hazard_statements:
          description: New GHS standard statements.
          items:
            $ref: "#/components/schemas/ChemicalsStatement"
          nullable: true
          type: array
        is_main_declaration:
          type: boolean
        labeling_ghs_euh_complete:
          nullable: true
          type: string
        mpid:
          type: string
        notification_bag:
          nullable: true
          type: string
        notification_bag_except_trade:
          nullable: true
          type: string
        number_in_bundle:
          nullable: true
          type: integer
        packaging_exceeds_limited_quantity:
          description: >-
            Whether the packaging of this product exceeds the Limited Quantity
            (LQ) that is set by transport agencies.


            PIM: gebindeGroesserLq
          nullable: true
          type: boolean
        poison_cabinet:
          description: "PIM: giftSchrankAufbewahrung."
          nullable: true
          type: boolean
        precautionary_statements:
          description: New GHS standard statements.
          items:
            $ref: "#/components/schemas/ChemicalsStatement"
          nullable: true
          type: array
        product_id:
          type: string
        release_date:
          format: date-time
          nullable: true
          type: string
        signal_word:
          description: "PIM: signalwort."
          nullable: true
          oneOf:
            - $ref: "#/components/schemas/ChemicalsStatement"
        status:
          type: string
        storage_class:
          description: |-
            Information about storing / transporting the good.

            PIM: lagerKlasse
          nullable: true
          oneOf:
            - $ref: "#/components/schemas/ChemicalsStatement"
        supplier_description:
          nullable: true
          type: string
        supplier_id:
          type: string
        svhc:
          nullable: true
          type: boolean
        tactile_hazard_warning:
          nullable: true
          type: boolean
        transport_category:
          description: "PIM: befoerderungsKategorie."
          nullable: true
          oneOf:
            - $ref: "#/components/schemas/ChemicalsStatement"
        tunnel_restriction:
          description: "PIM: tunnelrestriktionen."
          nullable: true
          oneOf:
            - $ref: "#/components/schemas/ChemicalsStatement"
        un_number:
          description: |-
            United nations number.

            PIM: unNummer
          nullable: true
          oneOf:
            - $ref: "#/components/schemas/ChemicalsStatement"
        updated_at:
          description: >-
            Time when declaration was last indexed with modifications in
            ElasticSearch.


            Only set on standalone chemicals declarations (not inside product).
          format: date-time
          nullable: true
          type: string
      required:
        - declaration_number
        - product_id
        - updated_at
        - status
        - is_main_declaration
        - supplier_id
      type: object
    ChemicalsStatement:
      description: Standardized information statement about chemical ingredients.
      properties:
        code:
          description: Standard code for this statement.
          type: string
        label:
          description: Natural language for this statement.
          type: string
      required:
        - code
        - label
      type: object
    ChemicalsCleaningAgent:
      description: Information on a cleaning agent in the chemicals declaration..
      properties:
        concentration:
          nullable: true
          oneOf:
            - $ref: "#/components/schemas/ChemicalsStatement"
        group:
          nullable: true
          oneOf:
            - $ref: "#/components/schemas/ChemicalsStatement"
        name:
          nullable: true
          type: string
      type: object
    ChemicalsMaterial:
      description: Information on a material in the chemicals declaration.
      properties:
        cas_number:
          nullable: true
          type: string
        einecs_number:
          nullable: true
          type: string
        name:
          type: string
      required:
        - name
      type: object
    Document:
      properties:
        cdn_url:
          type: string
        classification:
          type: string
        file_name:
          type: string
        source_system_id:
          type: string
        status:
          type: string
        type:
          $ref: "#/components/schemas/ChemicalsStatement"
        valid_from:
          nullable: true
          type: string
        valid_to:
          nullable: true
          type: string
      required:
        - source_system_id
        - cdn_url
        - file_name
        - status
        - classification
        - type
      type: object
    Image:
      description: An image and its properties.
      properties:
        code:
          description: Code for the image, useful for pictograms.
          nullable: true
          type: string
        description:
          description: Image description, useful for example as alt attribute.
          nullable: true
          type: string
        original:
          description: Full size image.
          type: string
        stack:
          description: Image URL with a placeholder for a Rokka {stack}.
          type: string
      type: object
  responses:
    "400":
      description: If the request parameters are invalid.
  securitySchemes:
    Kong-Api-Key:
      description: Kong key-auth authentication
      in: header
      name: X-Api-Key
      type: apiKey
    basicAuth:
      scheme: basic
      type: http
```