> ## 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 Declarations of Conformity > Retrieve your company's Declarations of Conformity (metadata only — the PDF is at each row's `pdfUrl`). A family declaration is one row; `specIds` lists every unit it covers and `activeSpecIds` the units it is currently the active DoC for. Soft-deleted declarations are never returned, and a permanently deleted declaration disappears from the list without a tombstone (also under `changedSince`). Rows are ordered by `issuedAt` (newest first, drafts last), then by `id`. Requires `packaging:read` (a `packaging:write` key satisfies it); customer workspace with the PPWR module enabled. ## OpenAPI ````yaml GET /api/v1/ppwr/declarations openapi: 3.1.0 info: title: Polygon One Compliance API description: >- REST API for connecting ERP and other business systems to Polygon One. It covers both compliance modules: **EUDR** (EU Deforestation Regulation) — articles, suppliers, plots, evidence, orders and Due Diligence Statements — and **PPWR** (EU Packaging and Packaging Waste Regulation) — packaging components and units, documents, Declarations of Conformity, the SKU quantity feed and volume reports. Authenticate every request with an API key created in Settings → API Keys, sent as `Authorization: Bearer `. Each key carries scopes (e.g. `articles:read`, `packaging:write`) that limit what it may read and write. Versioning: `v1` changes only additively — new endpoints, new optional request fields and new response fields may appear, nothing documented is removed or changed in meaning. Ignore response fields you do not know. Guides and walkthroughs: https://help.polygon-one.com/api-reference/introduction version: 1.0.0 contact: name: Polygon One Support email: help@polygon-one.eu servers: - url: https://app.polygon-one.com description: Production Server security: - bearerAuth: [] tags: - name: Articles description: >- EUDR articles: your products and purchased goods, their HS code, EUDR relevance and supplier links. - name: Suppliers description: EUDR suppliers and their links to articles. - name: Plots description: >- EUDR plots of land (geolocations): create, validate, link to supplier articles, read the geo analysis and its report. - name: Evidence description: >- EUDR evidence documents attached to a supplier article (legal compliance documents, questionnaires). - name: Orders description: >- Purchase and sale orders and their lines; the read-back of the DDS references linked to each order. - name: Import Jobs description: >- Status and result of an asynchronous batch import (articles, suppliers, orders, PPWR quantities). - name: Readiness description: Action-scoped readiness snapshots for owned EUDR and PPWR resources. - name: DDS Statements description: >- EUDR Due Diligence Statements: create, read, update the TRACES numbers, delete. - name: PPWR Packaging Data description: >- PPWR master data: packaging components, packaging units, their sizes, bills of materials and article links. - name: PPWR Documents description: >- Upload supporting documents (test reports, declarations, technical documentation) to a packaging unit or component. - name: PPWR Declarations of Conformity description: Read Declarations of Conformity and download their files. - name: PPWR Quantities & Volume Reports description: >- The SKU quantity feed, aggregate material tonnage and the generated volume reports (Mengenmeldung). paths: /api/v1/ppwr/declarations: get: tags: - PPWR Declarations of Conformity summary: List Declarations of Conformity description: >- Retrieve your company's Declarations of Conformity (metadata only — the PDF is at each row's `pdfUrl`). A family declaration is one row; `specIds` lists every unit it covers and `activeSpecIds` the units it is currently the active DoC for. Soft-deleted declarations are never returned, and a permanently deleted declaration disappears from the list without a tombstone (also under `changedSince`). Rows are ordered by `issuedAt` (newest first, drafts last), then by `id`. Requires `packaging:read` (a `packaging:write` key satisfies it); customer workspace with the PPWR module enabled. operationId: listPpwrDeclarations parameters: - schema: type: string format: uuid description: >- Only declarations covering this packaging unit (any version — the unit's DoC history). required: false description: >- Only declarations covering this packaging unit (any version — the unit's DoC history). name: specId in: query - schema: type: string enum: - draft - issued - superseded - withdrawn required: false name: status in: query - schema: type: string enum: - generated - collected required: false name: origin in: query - schema: type: string format: date-time description: >- Only declarations that changed at or after this instant (inclusive): issued, withdrawn, verified, collected file lost, superseded, or `activeSpecIds` shrank because a newer declaration took over one of its units — the replaced declaration and its successor both match. ISO 8601 with `Z` or an offset. Drafts carry no timestamp and never match. required: false description: >- Only declarations that changed at or after this instant (inclusive): issued, withdrawn, verified, collected file lost, superseded, or `activeSpecIds` shrank because a newer declaration took over one of its units — the replaced declaration and its successor both match. ISO 8601 with `Z` or an offset. Drafts carry no timestamp and never match. name: changedSince in: query - schema: type: integer minimum: 1 maximum: 1000 default: 100 description: Maximum number of results to return (default 100, max 1000). required: false description: Maximum number of results to return (default 100, max 1000). name: limit in: query - schema: type: - integer - 'null' minimum: 0 default: 0 description: Number of results to skip for pagination. required: false description: Number of results to skip for pagination. name: offset in: query - schema: type: string description: >- Comma-separated list of the resource's top-level keys to return (per element for a list), e.g. `id,name`; omit for the full body. Top-level only; whitespace is trimmed and duplicates count once. `fields` never adds keys: a selected optional key that is absent on a row stays absent. `400` when passed more than once, when empty, or when it names an unknown key (the error names it and lists the allowed ones). required: false description: >- Comma-separated list of the resource's top-level keys to return (per element for a list), e.g. `id,name`; omit for the full body. Top-level only; whitespace is trimmed and duplicates count once. `fields` never adds keys: a selected optional key that is absent on a row stays absent. `400` when passed more than once, when empty, or when it names an unknown key (the error names it and lists the allowed ones). name: fields in: query responses: '200': description: List of declarations content: application/json: schema: type: array items: $ref: '#/components/schemas/PpwrDeclaration' example: - id: f1a5c9e3-4b72-4d86-b3f0-7e2a6c8d1b95 version: 1 status: issued origin: generated referenceNumber: DOC-U-1-A4C8E2-V1 issuedAt: '2026-04-14T12:00:00.000Z' withdrawnAt: null supersededAt: null supersedesId: null verified: true isFallback: false pdfUrl: >- /api/v1/ppwr/declarations/f1a5c9e3-4b72-4d86-b3f0-7e2a6c8d1b95/pdf specIds: - a4c8e2f6-9b13-4d75-a1e8-3f7c0b6d9e52 activeSpecIds: - a4c8e2f6-9b13-4d75-a1e8-3f7c0b6d9e52 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalError' components: schemas: PpwrDeclaration: type: object properties: id: type: string description: >- UUID of the declaration — what `GET /api/v1/ppwr/declarations/{id}` takes. version: type: number description: >- Version number; a successor that supersedes this declaration carries a higher one. status: type: string description: >- Status of the declaration: `draft`, `issued`, `superseded` or `withdrawn`. One of: `draft`, `issued`, `superseded`, `withdrawn`. origin: type: string description: >- `generated` (drawn up in the app) or `collected` (the manufacturer's uploaded DoC). One of: `generated`, `collected`. referenceNumber: type: - string - 'null' description: >- Reference number printed on the declaration, or `null` (e.g. for a draft). issuedAt: type: - string - 'null' description: When the declaration was issued (ISO 8601, UTC); `null` for a draft. withdrawnAt: type: - string - 'null' description: >- When the declaration was withdrawn (ISO 8601, UTC); `null` unless withdrawn. supersededAt: type: - string - 'null' description: >- When a newer declaration replaced this one for its last unit (ISO 8601, UTC); `null` unless `status` is `superseded`, and can also be `null` for a declaration superseded before 2026-10 whose successors were since deleted. A family declaration that loses only some units to a newer one stays `issued` with `supersededAt: null` — those units leave its `activeSpecIds`. supersedesId: type: - string - 'null' description: UUID of the earlier declaration this one replaces, or `null`. verified: type: boolean description: >- A generated DoC always; a collected DoC once its verification passed and while its file is on record. isFallback: type: boolean description: An importer substitute DoC (Ersatz-Konformitätserklärung). pdfUrl: type: - string - 'null' description: >- Path of the PDF download (`GET`, same API key); `null` for a draft, and for a collected declaration whose uploaded file is no longer on record (the download would answer `404`) — `verified` is then `false` too. specIds: type: array items: type: string description: >- Every packaging unit the declaration covers (a family DoC covers several). activeSpecIds: type: array items: type: string description: The units it is currently the active DoC for. required: - id - version - status - origin - referenceNumber - issuedAt - withdrawnAt - supersededAt - supersedesId - verified - isFallback - pdfUrl - specIds - activeSpecIds ErrorResponse: type: object properties: error: type: string description: >- Human-readable message, or a stable machine key (e.g. `batchTooLarge`, `overwriteRequired`, `duplicate`) on the batch, PPWR and upload endpoints. code: type: string description: >- Stable machine code on some `400` and `409` answers, e.g. `plot_geometry_invalid` or `FORK_HAS_ORDER`. Match on it rather than on `error`. Further flat keys may accompany it (e.g. `precisionDigits`, `field`). details: type: array items: $ref: '#/components/schemas/ValidationIssue' description: The validation issues on a `400` validation error. warnings: type: array items: type: object properties: type: type: string enum: - duplicateName - duplicateEan description: >- `duplicateName`: a live article of your company already has this name. `duplicateEan`: a live article already has this EAN. existingInternalArticleNr: type: string description: >- `duplicateName` only: internal article number of the existing article. existingArticleName: type: string description: '`duplicateEan` only: name of the existing article.' required: - type description: >- `POST /articles` `409` only: soft duplicate warnings. Resend with `acknowledgeWarnings: true` to create the article anyway. required: - error additionalProperties: {} description: >- Error body of every endpoint except the `429` the edge answers. Some errors add flat machine-readable keys next to `error`, e.g. `maxBatchSize` on `413 batchTooLarge` or `confirmUpdateCount` on `409 overwriteRequired`. RateLimitedResponse: type: object properties: error: type: object properties: code: type: string enum: - rate_limited description: Always `rate_limited`. message: type: string description: Human-readable explanation. required: - code - message description: Unlike every other error body, `error` is an object here. required: - error ValidationIssue: type: object properties: code: type: string description: >- Machine code of the issue, e.g. `invalid_type`, `too_small`, `custom`. path: type: array items: anyOf: - type: string - type: number description: >- Location of the offending value in the request: object keys and 0-based array positions. message: type: string description: >- Human-readable English explanation. The wording may change; match on `code` and `path`. required: - code - path - message additionalProperties: {} description: >- One validation issue. Issue-specific keys (e.g. `expected`, `minimum`) may accompany the three listed. responses: BadRequest: description: Invalid request data content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Validation failed details: - origin: string code: too_small minimum: 1 inclusive: true path: - address - street message: Address is required. Unauthorized: description: Invalid or expired API key, or the key's user account is not active. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Invalid or expired API key Forbidden: description: Insufficient permissions for this resource content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Forbidden TooManyRequests: description: >- Rate limit exceeded: currently 1000 requests per 60 seconds per client IP across all `/api` paths. Issued by the edge before the application runs, so the JSON body differs from every other error: `error` is an object. A `429` with an HTML body instead of JSON means the request carried no API key. content: application/json: schema: $ref: '#/components/schemas/RateLimitedResponse' example: error: code: rate_limited message: … InternalError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Internal server error securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- API key generated in Settings > API Keys. Include as `Authorization: Bearer `. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.