> ## Documentation Index
> Fetch the complete documentation index at: https://help.polygon-one.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Volume Reports

> List the generated reports, newest first. Metadata only — never the frozen computation. Filters and paging are optional; paging is applied after the filters. An invalid value for a known parameter is a `400`; unrecognized parameter names are ignored. Requires `packaging:read`; customer workspace with the PPWR module enabled — see the guide.



## OpenAPI

````yaml GET /api/ppwr/mengenmeldung/reports
openapi: 3.1.0
info:
  title: Polygon One Compliance API
  description: >-
    API for integrating ERP systems with the Polygon One EUDR Compliance
    Platform. Allows management of Articles, Suppliers, Orders, and Due
    Diligence Statements (DDS). PPWR packaging master data, the SKU quantity
    feed and Mengenmeldung reports are covered by the PPWR groups.
  version: 1.0.0
servers:
  - url: https://app.polygon-one.com
    description: Production Server
security:
  - bearerAuth: []
paths:
  /api/ppwr/mengenmeldung/reports:
    get:
      summary: List Volume Reports
      description: >-
        List the generated reports, newest first. Metadata only — never the
        frozen computation. Filters and paging are optional; paging is applied
        after the filters. An invalid value for a known parameter is a `400`;
        unrecognized parameter names are ignored. Requires `packaging:read`;
        customer workspace with the PPWR module enabled — see the guide.
      operationId: listMengenmeldungReports
      parameters:
        - name: periodYear
          in: query
          required: false
          schema:
            type: integer
            minimum: 2000
            maximum: 2100
        - name: market
          in: query
          required: false
          schema:
            type: string
            pattern: ^[A-Za-z]{2}$
          description: ISO alpha-2 (case-insensitive).
        - name: status
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/MengenmeldungStatus'
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
      responses:
        '200':
          description: Reports, newest first
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MengenmeldungReport'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    MengenmeldungStatus:
      type: string
      enum:
        - generated
        - superseded
      description: >-
        Exactly one report per (`periodYear`, `market`, `format`) is `generated`
        — that is the one to download.
    MengenmeldungReport:
      type: object
      description: >-
        Metadata of a generated report. The frozen computation snapshot is never
        returned — download the artifact from `GET
        /api/ppwr/mengenmeldung/{reportId}/xml`.
      properties:
        id:
          type: string
          format: uuid
        periodYear:
          type: integer
        market:
          type: string
          description: ISO alpha-2 market code.
        format:
          $ref: '#/components/schemas/MengenmeldungFormat'
        reportType:
          type: string
          enum:
            - HPM1
            - HMM1
            - HJM1
            - HNM1
            - HAM1
            - ANNUAL
          description: >-
            The LUCID Meldungsart for `lucid_de`; worksheet registers always
            report `ANNUAL`.
        systemOperatorId:
          type: string
          description: >-
            The dual system's LUCID number. Empty string for worksheet
            registers, which have no system operator.
        xsdVersion:
          type: string
          description: >-
            The ZSVR schema version the file was built against; `worksheet-1`
            for worksheet registers, which have no XSD.
        status:
          $ref: '#/components/schemas/MengenmeldungStatus'
        version:
          type: integer
        supersedesId:
          type:
            - string
            - 'null'
          format: uuid
          description: The report this one replaced, or `null`.
        snapshotHash:
          type: string
          description: SHA-256 of the frozen snapshot.
        generatedAt:
          type: string
          format: date-time
    MengenmeldungFormat:
      type: string
      enum:
        - lucid_de
        - verpact_nl
        - ara_at
        - bdo_pl
        - miteco_es
        - conai_it
      description: >-
        Register format. Each accepts exactly one market: `lucid_de`→`DE`,
        `verpact_nl`→`NL`, `ara_at`→`AT`, `bdo_pl`→`PL`, `miteco_es`→`ES`,
        `conai_it`→`IT`.
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
        details:
          description: Additional error details (e.g. validation issues)
      required:
        - error
  responses:
    BadRequest:
      description: Invalid request data
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Unauthorized:
      description: Invalid or missing API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Forbidden:
      description: Insufficient permissions for this resource
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        API key generated in Settings > API Keys. Include as `Authorization:
        Bearer <key>`.

````