Get DDS Statement
curl --request GET \
--url https://app.polygon-one.com/api/v1/dds-statements/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.polygon-one.com/api/v1/dds-statements/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.polygon-one.com/api/v1/dds-statements/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.polygon-one.com/api/v1/dds-statements/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.polygon-one.com/api/v1/dds-statements/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.polygon-one.com/api/v1/dds-statements/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.polygon-one.com/api/v1/dds-statements/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "0c5e8a2f-7d49-4b16-9e3a-2f8d6b4c1a73",
"companyId": "3f6c2a8e-5b1d-4c7e-9a2f-6d8b1e4c0a17",
"createdByUserId": "9b2e7d41-0c6a-4f38-8e15-2a7c9d3b6f80",
"name": "Pine planks PO-2026-0042",
"country": "Germany",
"referenceNumber": "26DEXXXXXXXX01",
"verificationNumber": "AB12CD34",
"tracesUuid": "b5f0c3e8-2a47-4d91-9e6b-7c1a8f3d5e24",
"submittedOn": "2026-03-03T10:00:00.000Z",
"type": "import",
"source": "internal",
"articles": [
{
"id": "3a9d7e1c-5f62-4a08-b4c7-6e1f0d8a2b59",
"ddsStatementId": "0c5e8a2f-7d49-4b16-9e3a-2f8d6b4c1a73",
"supplierArticleId": "2e8f6a3c-9d17-4b52-8c4a-7f1e3d9b0a65",
"volume": 12500,
"supplementaryUnitValue": null,
"percentageEstimationOrDeviation": null,
"article": {
"id": "7c4e2b19-3a85-4d6f-b210-8e9a5c1d7f36",
"name": "Pine plank 20 mm",
"shortDescription": "Kiln-dried pine plank, 20 × 100 × 2400 mm",
"internalArticleNr": "ART-1001",
"externalArticleNr": null,
"ean": null,
"hsCode": "4407.11",
"articleType": "purchase",
"eudrRelevant": true,
"needsManualCheck": false,
"sourceScope": "standing",
"hsPlausibility": null,
"geoComplianceResults": [],
"legalComplianceResults": [],
"legalDocuments": [],
"legalCategoryResults": [],
"questionnaires": [],
"commodityGroup": "wood",
"weightPerPieceKg": 2.5,
"deletedAt": null,
"suppliers": [],
"plots": [],
"complianceResults": [],
"countryOfProduction": null
},
"supplier": {
"id": "5a1d8c3e-7f24-4b9a-a6e0-1c3f5b8d2e94",
"name": "Sawmill Example GmbH",
"contactName": "Alex Example",
"country": "Germany",
"status": "data_complete",
"externalSupplierId": "LIEF-4711",
"address": {
"street": "Industriestraße 12",
"city": "Musterstadt",
"postalCode": "12345"
},
"email": "sales@sawmill.example",
"articles": [],
"plots": [],
"complianceResults": [],
"isCompanySelf": false,
"supplierArticles": [],
"deletedAt": null,
"assignedToUserId": null,
"otpContactEmail": null,
"otpContactConfirmedAt": null,
"otpExemptUntil": null
},
"plots": [
{
"id": "8f3b5d2a-6e19-4c74-a8d3-0b7e2f9c4a16",
"companyId": "3f6c2a8e-5b1d-4c7e-9a2f-6d8b1e4c0a17",
"createdByUserId": "9b2e7d41-0c6a-4f38-8e15-2a7c9d3b6f80",
"name": "Example Farm plot 3",
"species": [
{
"commonName": "Loblolly pine",
"scientificName": "Pinus taeda"
}
],
"country": "BR",
"size": 2.35,
"requiresAreaPlausibilityReview": false,
"commodityGroup": "wood",
"productionDateFrom": "2025-01-01T00:00:00.000Z",
"productionDateTo": "2025-12-31T00:00:00.000Z",
"producerName": "Example Forestry Ltda.",
"createdAt": "2026-03-02T09:15:00.000Z",
"deforestationRiskResult": 0,
"updatedAt": "2026-03-02T09:21:41.000Z",
"analysisStatus": "completed",
"forestPercentage": 0,
"isDegraded": false
}
],
"plotsTruncated": false,
"assignedVolume": 12500,
"remainingVolume": 0
}
],
"orders": [
{
"id": "1b7f3e9d-4a26-4c85-b9e1-5d0a8c3f7e42",
"supplier": {
"id": "5a1d8c3e-7f24-4b9a-a6e0-1c3f5b8d2e94",
"name": "Sawmill Example GmbH",
"contactName": "Alex Example",
"country": "Germany",
"status": "data_complete",
"externalSupplierId": "LIEF-4711",
"address": {
"street": "Industriestraße 12",
"city": "Musterstadt",
"postalCode": "12345"
},
"email": "sales@sawmill.example",
"articles": [],
"plots": [],
"complianceResults": [],
"isCompanySelf": false,
"supplierArticles": [],
"deletedAt": null,
"assignedToUserId": null,
"otpContactEmail": null,
"otpContactConfirmedAt": null,
"otpExemptUntil": null
},
"orderNumber": "PO-2026-0042",
"orderDate": "2026-02-16T00:00:00.000Z",
"deliveryDate": "2026-04-30T00:00:00.000Z",
"orderType": "purchase",
"lines": [
{
"id": "6e2a9c4f-1b73-4d58-8f06-9c3e7a1b5d28",
"article": {
"id": "7c4e2b19-3a85-4d6f-b210-8e9a5c1d7f36",
"name": "Pine plank 20 mm",
"shortDescription": "Kiln-dried pine plank, 20 × 100 × 2400 mm",
"internalArticleNr": "ART-1001",
"externalArticleNr": null,
"ean": null,
"hsCode": "4407.11",
"articleType": "purchase",
"eudrRelevant": true,
"needsManualCheck": false,
"sourceScope": "standing",
"hsPlausibility": null,
"geoComplianceResults": [],
"legalComplianceResults": [],
"legalDocuments": [],
"legalCategoryResults": [],
"questionnaires": [],
"commodityGroup": "wood",
"weightPerPieceKg": 2.5,
"deletedAt": null,
"suppliers": [],
"plots": [],
"complianceResults": [],
"countryOfProduction": null,
"supplierLinks": [
{
"supplierId": "5a1d8c3e-7f24-4b9a-a6e0-1c3f5b8d2e94",
"supplierArticleId": "2e8f6a3c-9d17-4b52-8c4a-7f1e3d9b0a65"
}
]
},
"quantity": 12500,
"pieceCount": 5000,
"volumeM3": 25,
"dryWeight90Kg": null,
"positionId": "00010",
"deliveryDate": "2026-04-30T00:00:00.000Z"
}
],
"totalVolume": 12500,
"ddsReferences": [
{
"id": "0c5e8a2f-7d49-4b16-9e3a-2f8d6b4c1a73",
"referenceNumber": "26DEXXXXXXXX01",
"verificationNumber": "AB12CD34"
}
],
"status": "done"
}
],
"status": "validated",
"statusUpdatedAt": "2026-03-03T10:04:00.000Z",
"errorMessage": null,
"declaration": true,
"fullName": "Alex Example",
"notes": null,
"totalVolume": 12500,
"totalAssignedVolume": 12500,
"totalRemainingVolume": 0,
"verificationResult": null,
"verificationCheckedAt": null,
"groupHeadId": null,
"memberCount": 0
}{
"error": "Validation failed",
"details": [
{
"origin": "string",
"code": "too_small",
"minimum": 1,
"inclusive": true,
"path": [
"address",
"street"
],
"message": "Address is required."
}
]
}{
"error": "Invalid or expired API key"
}{
"error": "Forbidden"
}{
"error": "Resource not found"
}{
"error": {
"code": "rate_limited",
"message": "…"
}
}{
"error": "Internal server error"
}DDS Statements
Get DDS Statement
Retrieve one Due Diligence Statement of your company with its article lines (volumes and declared plots without geometry, at most 1000 per line), the orders linked to it and its TRACES numbers. A group head additionally carries members, a group member groupHeadReferenceNumber. A deleted statement and a statement of another company answer 404. Requires dds:read.
GET
/
api
/
v1
/
dds-statements
/
{id}
Get DDS Statement
curl --request GET \
--url https://app.polygon-one.com/api/v1/dds-statements/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.polygon-one.com/api/v1/dds-statements/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.polygon-one.com/api/v1/dds-statements/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.polygon-one.com/api/v1/dds-statements/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.polygon-one.com/api/v1/dds-statements/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.polygon-one.com/api/v1/dds-statements/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.polygon-one.com/api/v1/dds-statements/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "0c5e8a2f-7d49-4b16-9e3a-2f8d6b4c1a73",
"companyId": "3f6c2a8e-5b1d-4c7e-9a2f-6d8b1e4c0a17",
"createdByUserId": "9b2e7d41-0c6a-4f38-8e15-2a7c9d3b6f80",
"name": "Pine planks PO-2026-0042",
"country": "Germany",
"referenceNumber": "26DEXXXXXXXX01",
"verificationNumber": "AB12CD34",
"tracesUuid": "b5f0c3e8-2a47-4d91-9e6b-7c1a8f3d5e24",
"submittedOn": "2026-03-03T10:00:00.000Z",
"type": "import",
"source": "internal",
"articles": [
{
"id": "3a9d7e1c-5f62-4a08-b4c7-6e1f0d8a2b59",
"ddsStatementId": "0c5e8a2f-7d49-4b16-9e3a-2f8d6b4c1a73",
"supplierArticleId": "2e8f6a3c-9d17-4b52-8c4a-7f1e3d9b0a65",
"volume": 12500,
"supplementaryUnitValue": null,
"percentageEstimationOrDeviation": null,
"article": {
"id": "7c4e2b19-3a85-4d6f-b210-8e9a5c1d7f36",
"name": "Pine plank 20 mm",
"shortDescription": "Kiln-dried pine plank, 20 × 100 × 2400 mm",
"internalArticleNr": "ART-1001",
"externalArticleNr": null,
"ean": null,
"hsCode": "4407.11",
"articleType": "purchase",
"eudrRelevant": true,
"needsManualCheck": false,
"sourceScope": "standing",
"hsPlausibility": null,
"geoComplianceResults": [],
"legalComplianceResults": [],
"legalDocuments": [],
"legalCategoryResults": [],
"questionnaires": [],
"commodityGroup": "wood",
"weightPerPieceKg": 2.5,
"deletedAt": null,
"suppliers": [],
"plots": [],
"complianceResults": [],
"countryOfProduction": null
},
"supplier": {
"id": "5a1d8c3e-7f24-4b9a-a6e0-1c3f5b8d2e94",
"name": "Sawmill Example GmbH",
"contactName": "Alex Example",
"country": "Germany",
"status": "data_complete",
"externalSupplierId": "LIEF-4711",
"address": {
"street": "Industriestraße 12",
"city": "Musterstadt",
"postalCode": "12345"
},
"email": "sales@sawmill.example",
"articles": [],
"plots": [],
"complianceResults": [],
"isCompanySelf": false,
"supplierArticles": [],
"deletedAt": null,
"assignedToUserId": null,
"otpContactEmail": null,
"otpContactConfirmedAt": null,
"otpExemptUntil": null
},
"plots": [
{
"id": "8f3b5d2a-6e19-4c74-a8d3-0b7e2f9c4a16",
"companyId": "3f6c2a8e-5b1d-4c7e-9a2f-6d8b1e4c0a17",
"createdByUserId": "9b2e7d41-0c6a-4f38-8e15-2a7c9d3b6f80",
"name": "Example Farm plot 3",
"species": [
{
"commonName": "Loblolly pine",
"scientificName": "Pinus taeda"
}
],
"country": "BR",
"size": 2.35,
"requiresAreaPlausibilityReview": false,
"commodityGroup": "wood",
"productionDateFrom": "2025-01-01T00:00:00.000Z",
"productionDateTo": "2025-12-31T00:00:00.000Z",
"producerName": "Example Forestry Ltda.",
"createdAt": "2026-03-02T09:15:00.000Z",
"deforestationRiskResult": 0,
"updatedAt": "2026-03-02T09:21:41.000Z",
"analysisStatus": "completed",
"forestPercentage": 0,
"isDegraded": false
}
],
"plotsTruncated": false,
"assignedVolume": 12500,
"remainingVolume": 0
}
],
"orders": [
{
"id": "1b7f3e9d-4a26-4c85-b9e1-5d0a8c3f7e42",
"supplier": {
"id": "5a1d8c3e-7f24-4b9a-a6e0-1c3f5b8d2e94",
"name": "Sawmill Example GmbH",
"contactName": "Alex Example",
"country": "Germany",
"status": "data_complete",
"externalSupplierId": "LIEF-4711",
"address": {
"street": "Industriestraße 12",
"city": "Musterstadt",
"postalCode": "12345"
},
"email": "sales@sawmill.example",
"articles": [],
"plots": [],
"complianceResults": [],
"isCompanySelf": false,
"supplierArticles": [],
"deletedAt": null,
"assignedToUserId": null,
"otpContactEmail": null,
"otpContactConfirmedAt": null,
"otpExemptUntil": null
},
"orderNumber": "PO-2026-0042",
"orderDate": "2026-02-16T00:00:00.000Z",
"deliveryDate": "2026-04-30T00:00:00.000Z",
"orderType": "purchase",
"lines": [
{
"id": "6e2a9c4f-1b73-4d58-8f06-9c3e7a1b5d28",
"article": {
"id": "7c4e2b19-3a85-4d6f-b210-8e9a5c1d7f36",
"name": "Pine plank 20 mm",
"shortDescription": "Kiln-dried pine plank, 20 × 100 × 2400 mm",
"internalArticleNr": "ART-1001",
"externalArticleNr": null,
"ean": null,
"hsCode": "4407.11",
"articleType": "purchase",
"eudrRelevant": true,
"needsManualCheck": false,
"sourceScope": "standing",
"hsPlausibility": null,
"geoComplianceResults": [],
"legalComplianceResults": [],
"legalDocuments": [],
"legalCategoryResults": [],
"questionnaires": [],
"commodityGroup": "wood",
"weightPerPieceKg": 2.5,
"deletedAt": null,
"suppliers": [],
"plots": [],
"complianceResults": [],
"countryOfProduction": null,
"supplierLinks": [
{
"supplierId": "5a1d8c3e-7f24-4b9a-a6e0-1c3f5b8d2e94",
"supplierArticleId": "2e8f6a3c-9d17-4b52-8c4a-7f1e3d9b0a65"
}
]
},
"quantity": 12500,
"pieceCount": 5000,
"volumeM3": 25,
"dryWeight90Kg": null,
"positionId": "00010",
"deliveryDate": "2026-04-30T00:00:00.000Z"
}
],
"totalVolume": 12500,
"ddsReferences": [
{
"id": "0c5e8a2f-7d49-4b16-9e3a-2f8d6b4c1a73",
"referenceNumber": "26DEXXXXXXXX01",
"verificationNumber": "AB12CD34"
}
],
"status": "done"
}
],
"status": "validated",
"statusUpdatedAt": "2026-03-03T10:04:00.000Z",
"errorMessage": null,
"declaration": true,
"fullName": "Alex Example",
"notes": null,
"totalVolume": 12500,
"totalAssignedVolume": 12500,
"totalRemainingVolume": 0,
"verificationResult": null,
"verificationCheckedAt": null,
"groupHeadId": null,
"memberCount": 0
}{
"error": "Validation failed",
"details": [
{
"origin": "string",
"code": "too_small",
"minimum": 1,
"inclusive": true,
"path": [
"address",
"street"
],
"message": "Address is required."
}
]
}{
"error": "Invalid or expired API key"
}{
"error": "Forbidden"
}{
"error": "Resource not found"
}{
"error": {
"code": "rate_limited",
"message": "…"
}
}{
"error": "Internal server error"
}articles[].plots lists the distinct plots of the line without geometry, at most 1000 entries (ordered by id); articles[].plotsTruncated: true means more exist. Fetch a plot’s geometry via GET /api/v1/plots/{id}.Authorizations
API key generated in Settings > API Keys. Include as Authorization: Bearer <key>.
Path Parameters
Query Parameters
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).
Response
DDS statement details including articles, volumes, and linked orders
UUID of the DDS statement.
UUID of your company.
UUID of the user who created the statement, or null.
Name of the statement, or null.
Country of your company as recorded on its address when the statement was created, or null.
TRACES reference number (assigned after submission)
TRACES verification number (assigned after validation)
Identifier TRACES assigned on submission; null before submission and for external statements.
When the statement was submitted to TRACES (ISO 8601, UTC), or null.
Activity type: import, export, domestic_production or trade (see DdsType).
One of: internal, external.
The declared article lines.
Show child attributes
Show child attributes
Orders assigned to this DDS statement
Show child attributes
Show child attributes
One of: draft, processing, submitted, validated, rejected, under_control, correction_requested, deleted, failed, external, withdrawn, archived, grouped.
When status last changed (ISO 8601, UTC), or null.
Error message if submission failed
Whether the due-diligence declaration has been confirmed for this statement.
Name of the person who signed the declaration, or null.
Free-text notes, or null.
Sum of the lines' volume, in kilograms; null when any line has a null volume.
Sum of the lines' assignedVolume, in kilograms.
totalVolume minus totalAssignedVolume, in kilograms; null when totalVolume is null.
External statements only: the last TRACES check of the reference and verification number — existing_usable, existing_non_usable or non_existent; null when never checked. Only existing_usable means the statement may be relied on.
When verificationResult was obtained (ISO 8601, UTC), or null.
On a member of a TRACES statement group: UUID of the group head. null on every other statement.
Number of member statements when this statement is a group head; 0 otherwise.
By-id read of a group head only: its member statements. The item shape is not part of the v1 contract and may change — do not depend on it.
By-id read of a group member only: the TRACES reference number of its group head, or null.