Introduction

​

Overview

• Articles — Create, update, and query articles. EUDR relevance is determined automatically based on the HS code.
• Suppliers — Manage supplier data and link suppliers to articles.
• Plots (EUDR) — Create production plots with their geometry, read them back, link them to supplier articles, and delete them. The deforestation analysis runs automatically after creation.
• Plot report and geometry check (EUDR) — Download the plot report as PDF, and check a geometry without creating a plot. See Geo analysis.
• Evidence (EUDR) — Upload documents, attach them to a supplier article, and list them.
• Orders — Import purchase and sale orders (individually or in batches). Orders can be assigned to DDS statements automatically.
• DDS Statements — Create and manage due diligence statements for TRACES submission.
• Packaging master data (PPWR) — Bulk create and update components, packaging units, their sizes and the links between them; units and components can be read back individually and as a list.
• Quantity feed (PPWR) — Push the volumes placed on the market per SKU, market and year, or aggregate tonnage per material category.
• Volume reports (PPWR) — Generate and list reports for LUCID and the other national registers, and download the file.
• Documents (PPWR) — Upload test reports, declarations and drawings and attach them to packaging units and components.
• Declarations of Conformity (PPWR) — Read each unit’s DoC state, list the declarations, and download the PDF.

​

Authentication

1. Navigate to Settings > API Keys
2. Click Create API Key
3. Select the required permissions (e.g. articles:read, orders:write)
4. Copy the generated key

Authorization: Bearer eudr_8f7d2a...

​

OAuth 2.1

​

Base URL

https://app.polygon-one.com

​

Versioning

• Contract scope: Only the endpoints documented in this reference are part of v1. Other paths under these prefixes may change. API keys are not part of the API — you create them under Settings > API Keys.
• Additive only: Within v1, existing fields are never removed or renamed. New response fields may be added — your client must ignore unknown fields. Unknown request fields are accepted and ignored.
• Errors: The body is { "error": string } (optionally with details or warnings), and HTTP status codes stay stable. The one exception is the rate-limit 429, see Errors & limits.
• Breaking changes ship only as /api/v2/, with at least 6 months of parallel operation.

​

Permissions

​

Response Format

{
  "article": { "id": "...", "name": "..." }
}

{
  "jobId": "6f7a...",
  "status": "queued",
  "statusUrl": "/api/import-jobs/6f7a..."
}

​

Field selection (fields)

# ERP delta poll: order number + TRACES references only
curl "https://app.polygon-one.com/api/v1/orders?changedSince=2026-09-25T06:00:00Z&limit=1000&fields=orderNumber,ddsReferences" \
  -H "Authorization: Bearer eudr_8f7d2a..."

• fields must be passed once (comma-separated, not repeated).
• The list must not be empty (?fields= alone is rejected).
• Every name must be a documented top-level field of the resource; unknown names are listed in the error message together with the allowed fields. A field we add later can therefore never silently change an existing request.
• Whitespace around names is ignored and duplicates count once. There is no nested selection (supplier.id).

​

Error Handling

{
  "error": "Validation failed",
  "details": [
    { "code": "too_small", "path": ["address", "street"], "message": "Address is required." }
  ]
}

​

Duplicate warnings

• Hard conflict (cannot be overridden): an article with the same internalArticleNr already exists. The response is 409 with an error message.
• Soft warnings (overridable): a duplicate article name (duplicateName) or a duplicate ean (duplicateEan). The response is 409 with a machine-readable warnings array:

{
  "error": "Article has unresolved warnings. Resubmit with acknowledgeWarnings=true to override.",
  "warnings": [
    { "type": "duplicateName", "existingInternalArticleNr": "ART-001" },
    { "type": "duplicateEan", "existingArticleName": "Oak plank 20mm" }
  ]
}