Due Diligence Statement (DDS) — V3 API Reference¶
Service: EUDRDueDiligenceStatementServiceV3
Namespace: http://ec.europa.eu/tracesnt/certificate/eudr/due-diligence-statement/v3
Endpoint: /tracesnt/ws/EUDRDueDiligenceStatementServiceV3
Security: WS-Security (UsernameToken over HTTPS)
Overview¶
EUDR Due Diligence Statement (DDS) service for operators pursuant to Regulation. A Due Diligence Statement is submitted by an Information System user prior to placing relevant products on the market or exporting them. The due diligence process comprises three steps: information gathering, risk assessment, and risk mitigation. An operator is any natural or legal person who, in the course of a commercial activity, places relevant products on the market or exports them. The Information System assigns a reference number and a verification number to each submitted DDS.
Operations¶
submitDds¶
Submit a new Due Diligence Statement. The operator or authorised representative submits a DDS prior to placing relevant products on the Union market or exporting them. Accepts optional references for grouping: the voluntary act of creating a new DDS that references previously submitted DDS or SD declarations via their reference numbers. Referenced declarations receive GROUPED status and cannot be individually withdrawn or amended while the referencing grouped declaration is active. Blocked if any referenced statement is not in available status. Role: OPERATOR or REPRESENTATIVE_OPERATOR. Returns the UUID assigned by the Information System.
- Request:
SubmitDdsRequest(Type:SubmitDdsRequestType) - Response:
SubmitDdsResponse(Type:SubmitDdsResponseType) - Faults:
BusinessRulesValidationException,PermissionDeniedException
amendDds¶
Amend an existing Due Diligence Statement within the 72-hour amendment window. The 72-hour window starts from submission and allows the operator to amend the declaration while retaining the same reference number. After this window closes, amendments result in a new submission with a new identifier. Re-triggers risk profiling — the identification of risks of non-compliance based on risk criteria for the purpose of assigning a risk status to the DDS. Blocked if the DDS is not in available status or is subject to a customs lock — the immutability constraint applied once the DDS has been used for customs clearance (release for free circulation or export).
- Request:
AmendDdsRequest(Type:AmendDdsRequestType) - Response:
AmendDdsResponse(Type:DdsModificationResponseType) - Faults:
BusinessRulesValidationException,PermissionDeniedException
withdrawDds¶
Withdraw a Due Diligence Statement within the 72-hour amendment window. Blocked if the DDS has GROUPED status — a lifecycle state assigned when the DDS has been associated to a grouped declaration. Also blocked if the DDS is under active checks by competent authorities or is subject to a customs lock.
- Request:
WithdrawDdsRequest(Type:WithdrawDdsRequestType) - Response:
WithdrawDdsResponse(Type:DdsModificationResponseType) - Faults:
BusinessRulesValidationException,PermissionDeniedException
getDds¶
Retrieve DDS overview (status, reference number, and verification number) by providing the UUID assigned by the Information System.
- Request:
GetDdsRequest(Type:GetDdsRequestType) - Response:
GetDdsResponse(Type:DdsOverviewResponseType) - Faults:
NotFoundException
getDdsByInternalReference¶
Retrieve DDS overview (status, reference number, and verification number) by providing the internal reference number assigned by the operator's own system.
- Request:
GetDdsByInternalReferenceRequest(Type:GetDdsByInternalReferenceRequestType) - Response:
GetDdsByInternalReferenceResponse(Type:DdsOverviewResponseType) - Faults:
NotFoundException
getDdsByIdentifiers¶
Retrieve full DDS content by providing the reference number and verification number. The verification number is a security number assigned by the Information System to ensure additional security of data. This operation is available only to non-SME operators (standard operators and authorised representatives). SME downstream operators do not have access to this operation.
- Request:
GetDdsByIdentifiersRequest(Type:GetDdsByIdentifiersRequestType) - Response:
GetDdsByIdentifiersResponse(Type:GetDdsByIdentifiersResponseType) - Faults:
NotFoundException
Types¶
SubmitDdsRequestType¶
Submit a new Due Diligence Statement pursuant to Regulation. The DDS documents the three-step due diligence process: information gathering, risk assessment, and risk mitigation. Accepts optional references for grouping — the voluntary act of creating a new DDS that references previously submitted DDS or SD declarations via their reference numbers. Validation is atomic: blocked if any referenced statement has GROUPED status. The Information System assigns a reference number and verification number upon successful submission.
| Field | Type | Required | Description |
|---|---|---|---|
operatorRole |
OperatorRoleType |
Yes | — |
statement |
DueDiligenceStatementBaseType |
Yes | — |
SubmitDdsResponseType¶
Response containing the UUID assigned by the Information System to the submitted DDS.
| Field | Type | Required | Description |
|---|---|---|---|
uuid |
UuidType |
Yes | — |
AmendDdsRequestType¶
Amend an existing DDS within the 72-hour amendment window. The operator may amend the declaration while retaining the same reference number. After this window closes, amendments result in a new submission with a new identifier. Blocked if the DDS is not in available status or is subject to a customs lock — the immutability constraint applied once used for customs clearance. Grouped declarations cannot be added, modified or removed on amend: submitting a statement that contains groupedDeclarations is rejected with the EUDR-GROUPING-NOT-ALLOWED-ON-AMEND error. Grouping can only be set on the initial submission. Re-triggers risk profiling.
| Field | Type | Required | Description |
|---|---|---|---|
uuid |
UuidType |
Yes | — |
statement |
DueDiligenceStatementBaseType |
Yes | — |
WithdrawDdsRequestType¶
Withdraw a DDS within the 72-hour amendment window. Blocked if the DDS is not in available status — a lifecycle state assigned when associated to a grouped declaration.
| Field | Type | Required | Description |
|---|---|---|---|
uuid |
UuidType |
Yes | — |
DdsModificationResponseType¶
Response for amend/withdraw operations, containing the resulting DDS lifecycle status.
| Field | Type | Required | Description |
|---|---|---|---|
uuid |
UuidType |
Yes | — |
status |
EudrStatusType |
Yes | — |
GetDdsRequestType¶
Request to retrieve DDS overview by one or more UUIDs assigned by the Information System.
| Field | Type | Required | Description |
|---|---|---|---|
uuidList |
UuidType |
Yes | — |
GetDdsByInternalReferenceRequestType¶
Request to retrieve DDS overview from the operator-assigned internal reference number.
| Field | Type | Required | Description |
|---|---|---|---|
internalReference |
InternalReferenceNumberType |
Yes | — |
DdsOverviewResponseType¶
Response containing DDS overview information: UUID, internal reference, reference number, verification number, lifecycle status, and optional rejection reason or communication from competent authority.
| Field | Type | Required | Description |
|---|---|---|---|
ddsOverviewList |
OverviewType |
No | — |
GetDdsByIdentifiersRequestType¶
Request to retrieve full DDS content by providing the reference number and verification number — the security number assigned by the Information System to ensure additional security of data.
| Field | Type | Required | Description |
|---|---|---|---|
referenceAndVerificationNumber |
ReferenceAndVerificationNumberType |
Yes | — |
GetDdsByIdentifiersResponseType¶
Response containing the full DDS statement payload retrieved by reference and verification numbers.
| Field | Type | Required | Description |
|---|---|---|---|
statement |
DueDiligenceStatementBaseType |
Yes | — |
DueDiligenceStatementBaseType¶
Core payload of a Due Diligence Statement. Contains the information of product details, operator identification, geolocation of production plots, and country of production. Relevant commodities: cattle, cocoa, coffee, oil palm, rubber, soya and wood. Relevant products: products listed in Annex I that contain, have been fed with or have been made using relevant commodities. Products must be deforestation-free: produced on land not deforested after 31 Dec 2020; for wood, harvested without inducing forest degradation after 31 Dec 2020.
| Field | Type | Required | Description |
|---|---|---|---|
internalReferenceNumber |
InternalReferenceNumberType |
No | Internal reference in the operator's own system. If not provided, generated by the Information System. |
activityType |
ActivityType |
Yes | The type of commercial activity: IMPORT (release for free circulation), EXPORT, or DOMESTIC (placing on the market). |
representedOperator |
EconomicOperatorIdentificationType |
No | The represented operator on whose behalf the authorised representative is acting. Required when operatorRole is REPRESENTATIVE_OPERATOR. Contains operatorReferenceNumber, address, email, name and phone. |
countryOfActivity |
EuropeanCountryType |
No | EU Member State where the economic activity takes place. |
borderCrossCountry |
EuropeanCountryType |
No | Country of entry (for IMPORT activity) or country of exit (for EXPORT activity) at the customs territory border. |
comment |
EditorialCommentType |
No | Editorial comment for the competent authority. |
commodities |
DdsCommodityType |
Yes | Relevant commodities and products declared in this DDS. Each commodity includes HS code, commercial description, quantity, producer geolocation, and country of production. |
geoLocationConfidential |
boolean |
Yes | If TRUE, geolocation data is confidential and not disclosed down the supply chain. If FALSE, geolocation data can be disclosed to downstream operators and traders. |
groupedDeclarations |
GroupedDeclarationsType |
No | For the purposes of the grouping function, the group head must be a complete declaration in its own right: it must list the relevant commodities or products being placed on the market or exported from it, with their quantities, HS codes and other data elements. Because the group head is the reference used towards customs and competent authorities and first downstream operators and traders, its content must reflect what is actually being placed on the market. The geolocation that is carried by the individual member declarations, which the group head references and represents under Art 8a(3); it does not need to be repeated on the head. Responsibility for entering correct data about the relevant commodities and products, including the quantities in the group head submission rests with the operator. The Information System does not automatically reconcile the group head's products and quantities from the group the members. |
DdsCommodityType¶
A commodity entry in the DDS, representing a relevant commodity or relevant product. Includes HS code classification, commercial description, species information (for wood), and producer geolocation data.
| Field | Type | Required | Description |
|---|---|---|---|
position |
long |
No | Ordinal position of this commodity within the DDS. |
descriptors |
CommercialDescriptionType |
Yes | Commercial description and quantity measures for this commodity. |
hsHeading |
HSHeadingType |
Yes | Commodity code from the Harmonized Commodity Description and Coding System (HS). 2 to 10 digit code identifying the product category. |
speciesInfo |
SpeciesInformationType |
No | Species information required for wood-based products to support verification that harvesting did not induce forest degradation. |
producers |
DdsProducerType |
No | Producers of this commodity with geolocation of the plot of land where the commodity was produced. Geolocation must be expressed as lat/long coordinates with 6 decimal digits minimum; polygons required for plots greater than 4 hectares (except cattle). |
DdsProducerType¶
Producer information including country of production and geolocation of the plot of land where the commodity was produced. Geolocation is provided as GeoJSON geometry (base64 encoded): lat/long coordinates with minimum 6 decimal digits; polygons for plots greater than 4 hectares (except cattle where establishment coordinates suffice).
| Field | Type | Required | Description |
|---|---|---|---|
position |
long |
No | Ordinal position of this producer within the commodity. |
country |
CountryType |
Yes | Country of production: the country where the relevant commodity was produced. ISO 3166-1 alpha-2 code. |
name |
string (max 500) |
No | Name of the producer (natural or legal person). |
geometryGeojson |
base64Binary |
Yes | GeoJSON geometry (base64 encoded) representing the geolocation of the plot of land. Must contain lat/long coordinates with minimum 6 decimal digits. Polygons required for plots greater than 4 hectares (except cattle where point coordinates for the establishment suffice). Supported geometry types: Point, MultiPoint, Polygon, MultiPolygon, GeometryCollection. |
SpeciesInformationType¶
| Field | Type | Required | Description |
|---|---|---|---|
scientificName |
ScientificNameType |
No | The scientific name is string not case sensitive. |
commonName |
ScientificNameType |
No | The common name is string not case sensitive. |
OperatorRoleType¶
Roles permitted for DDS submission. OPERATOR: any natural or legal person who, in the course of a commercial activity, places relevant products on the market or exports them, excluding downstream operators. REPRESENTATIVE_OPERATOR: an authorised representative — any natural or legal person established in the Union who has received a written mandate from an operator to act on its behalf in relation to specified tasks with regard to the operator's obligations under Regulation.
| Value | Description |
|---|---|
OPERATOR |
Operator: places relevant products on the market or exports them |
REPRESENTATIVE_OPERATOR |
Authorised representative: acts on behalf of an operator under written mandate |
Constraints: Base: string
ScientificNameType¶
Used to specify the scientific (or common) name (Box 6).
Constraints: Base: string, Max length: 200, Min length: 1
Common Types¶
AddressType¶
| Field | Type | Required | Description |
|---|---|---|---|
country |
CountryType |
Yes | — |
street |
StreetAndNumberType |
Yes | — |
postalCode |
PostalCodeType |
Yes | — |
city |
CityType |
Yes | — |
fullAddress |
NonStructuredAddressType |
No | — |
EconomicOperatorIdentificationType¶
| Field | Type | Required | Description |
|---|---|---|---|
operatorReferenceNumber |
EconomicOperatorReferenceNumberType |
No | — |
operatorAddress |
AddressType |
No | — |
operatorEmail |
EmailType |
No | — |
operatorPhone |
PhoneType |
No | — |
operatorName |
string (max 200) |
Yes | — |
EconomicOperatorReferenceNumberType¶
| Field | Type | Required | Description |
|---|---|---|---|
identifierType |
IdentifierTypeType |
Yes | — |
identifierValue |
IdentifierValueType |
Yes | — |
GroupedDeclarationsType¶
| Field | Type | Required | Description |
|---|---|---|---|
groupedDeclaration |
ReferenceNumberType |
Yes | — |
ReferenceAndVerificationNumberType¶
| Field | Type | Required | Description |
|---|---|---|---|
referenceNumber |
ReferenceNumberType |
Yes | — |
verificationNumber |
VerificationNumberType |
Yes | — |
OverviewType¶
| Field | Type | Required | Description |
|---|---|---|---|
uuid |
UuidType |
Yes | — |
internalReferenceNumber |
InternalReferenceNumberType |
Yes | — |
referenceNumber |
ReferenceNumberType |
No | — |
verificationNumber |
VerificationNumberType |
No | — |
status |
EudrStatusType |
Yes | — |
rejectionReason |
RejectionReasonType |
No | — |
communicationToOperator |
CommunicationToOperatorType |
No | — |
date |
dateTime |
No | — |
updatedBy |
UpdatedByType |
No | — |
version |
integer |
No | — |
CommunicationToOperatorType¶
Communication sent by CA to Operator
| Field | Type | Required | Description |
|---|---|---|---|
date |
dateTime |
Yes | Creation or amend date. |
content |
string (max 1000) |
Yes | Message content. |
CommercialDescriptionType¶
This type allows you to express one single commercial description and associate it with individual quantitative metrics.
| Field | Type | Required | Description |
|---|---|---|---|
descriptionOfGoods |
string (max 150) |
Yes | Single commercial description. |
goodsMeasure |
GoodsMeasureType |
Yes | Units of measurement combinations for the declared commodity |
GoodsMeasureType¶
| Field | Type | Required | Description |
|---|---|---|---|
percentageEstimationOrDeviation |
DecimalThreePrecType |
No | Percentage estimate or deviation |
netWeight |
DecimalSixteenTotalSixPrecType |
No | This is mandatory if activity type is IMPORT/EXPORT. The weight must be provided in Kg. |
supplementaryUnit |
DecimalSixteenTotalSixPrecType |
No | The number of units, when a manufactured product is quantified in this way. |
supplementaryUnitQualifier |
SupplementaryUnitQualifierType |
No | This field must be provided if the value is provided in supplementaryUnit field. It represents the type of the numberofUnits field. |
EudrStatusType¶
Universal lifecycle status for EUDR documents
| Value | Description |
|---|---|
SUBMITTED |
— |
AVAILABLE |
— |
REJECTED |
— |
WITHDRAWN |
— |
ARCHIVED |
— |
SUSPENDED |
Not active in current release |
UPDATED |
Not active in current release |
GROUPED |
— |
OBSOLETE |
— |
Constraints: Base: string
ReferenceNumberType¶
Constraints: Base: string, Max length: 14
InternalReferenceNumberType¶
Constraints: Base: string, Max length: 50
CountryType¶
ISO 3166-1 alpha-2 codes
Constraints: Base: string, Pattern: [a-zA-Z]{2}
StreetAndNumberType¶
Constraints: Base: string, Max length: 300, Min length: 1
NonStructuredAddressType¶
Constraints: Base: string, Max length: 250, Min length: 1
UuidType¶
Universally unique identifier (UUID).
Constraints: Base: string, Pattern: [0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}
VerificationNumberType¶
Verification number
Constraints: Base: string, Max length: 35, Min length: 5
ActivityType¶
| Value | Description |
|---|---|
DOMESTIC |
— |
IMPORT |
— |
EXPORT |
— |
Constraints: Base: string
PostalCodeType¶
Constraints: Base: string, Max length: 80, Min length: 1
CityType¶
Constraints: Base: string, Max length: 200, Min length: 1
EmailType¶
Constraints: Base: string, Pattern: [a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}, Max length: 200
PhoneType¶
Constraints: Base: string, Max length: 50
EditorialCommentType¶
A version of a SD may have an editorial comment associated to it, with an explanation for the CA (Box 5)
Constraints: Base: string, Max length: 2000
UpdatedByType¶
Constraints: Base: string, Max length: 200, Min length: 1
RejectionReasonType¶
Rejection reason of the DDS
Constraints: Base: string, Max length: 1000, Min length: 0
IdentifierTypeType¶
| Value | Description |
|---|---|
eori |
Economic Operators Registration and Identification number (EORI) |
vat |
VAT identification number (VATIN) |
gln |
Global location number |
tin |
Tax Identification Number (TIN) |
cbr |
Central Business Register (CBR) |
cin |
Company Identification Number (CIN) |
duns |
The nine-digit D-U-N-S Number (DUNS) |
comp_num |
National company number (NCN) |
comp_reg |
Registration number in official national company register (NCR) |
oni |
Other National Identifier (ONI) |
Constraints: Base: string
IdentifierValueType¶
Constraints: Base: string, Max length: 80
SupplementaryUnitQualifierType¶
Constraints: Base: string, Max length: 4, Min length: 3
DecimalThreePrecType¶
Decimal type with precision three
Constraints: Base: decimal
DecimalSixteenTotalSixPrecType¶
Decimal number with a total of 16 and 6 fraction digits
Constraints: Base: decimal
HSHeadingType¶
Commodity code from the Harmonized Commodity Description and Coding System
Constraints: Base: string, Pattern: [0-9]{2,10}, Max length: 10, Min length: 2
EuropeanCountryType¶
| Value | Description |
|---|---|
AT |
Austria |
BE |
Belgium |
BG |
Bulgaria |
CY |
Cyprus |
CZ |
Czech Republic |
DE |
Germany |
DK |
Denmark |
EE |
Estonia |
ES |
Spain |
FI |
Finland |
FR |
France |
GR |
Greece |
HR |
Croatia |
HU |
Hungary |
IE |
Ireland |
IT |
Italy |
LT |
Lithuania |
LU |
Luxembourg |
LV |
Latvia |
MT |
Malta |
NL |
Netherlands |
PL |
Poland |
PT |
Portugal |
RO |
Romania |
SE |
Sweden |
SI |
Slovenia |
SK |
Slovakia (Slovak Republic) |
XI |
United Kingdom (Northern Ireland) |
Constraints: Base: string