PRprewave
EUDR - Customers - DDS

Create and submit a customer DDS for an origin request

Changed on

Creates a Customer Due Diligence Statement scoped to one origin request and submits it asynchronously. The origin request must belong to an accessible inbound product and have an Allowed DDS gate.

Required permission: access_public_products

post/public/v2/eudr/customers/origin-requests/{originRequestId}/customer-dds

Request

Path parameters

originRequestIdinteger required

The ID of the origin request.

Request body

customerNamestring required

Name of the customer as stated on the DDS.

customerCitystring required

City of the customer as stated on the DDS.

customerPostalCodestring required

Postal code of the customer as stated on the DDS.

customerStreetstring required

Street of the customer as stated on the DDS.

customerCountryCodestring required

ISO 3166-1 alpha-2 customer country code.

activityType'Import' | 'Export' | 'Domestic' required

Activity type for customer DDS create-and-submit. Allowed values: Import, Export, Domestic.

countryOfActivityCodestring nullable

ISO 3166-1 alpha-2 country of activity. Optional.

netWeightInKgnumber required

Net weight of the product in kg.

quantitynumber nullable

Product quantity.

unitstring nullable

Unit of the quantity.

percentageEstimationOrDeviationinteger nullable

Percentage estimation or deviation (0–15). Required for Domestic; must be omitted for Import/Export.

Example request

{
  "identifier": {
    "eori": "EU123456789"
  },
  "customerName": "Acme GmbH",
  "customerCity": "Vienna",
  "customerPostalCode": "1010",
  "customerStreet": "Main Street 1",
  "customerCountryCode": "AT",
  "countryOfActivityCode": "AT",
  "netWeightInKg": 1250.75,
  "quantity": 10,
  "unit": "m3",
  "percentageEstimationOrDeviation": 5
}

Response

Accepted. Location points to GET /public/v2/eudr/customers/customer-dds?ids={id}.

idinteger required

Customer DDS ID

productIdinteger required

Inbound product ID

updatedAtstring date-time required

Last modification. Timestamp (ISO 8601 UTC)

originRequestIdsinteger[] required

Origin request IDs linked to this customer DDS

referenceNumberstring nullable

EU reference number

verificationNumberstring nullable

Verification number

datestring date-time required

DDS date. Timestamp (ISO 8601 UTC)

customerNamestring required

Customer name on the DDS

customerCitystring required

Customer city

customerPostalCodestring required

Customer postal code

customerStreetstring required

Customer street

customerCountryCodestring required

ISO 3166-1 alpha-2 customer country code

state'New' | 'Submitting' | 'Submitted' | 'SubmissionError' | 'Available' | 'Rejected' | 'Cancelled' | 'Withdrawn' | 'Archived' | 'Suspended' | 'Updated' | 'Grouped' | 'Obsolete' required

Public customer DDS state.

activityType'Import' | 'Export' | 'Domestic' | 'Trade' required

Public activity type on responses and legacy payloads. Trade is deprecated and retained only for legacy data; create-and-submit uses PublicCustomerDDSCreateActivityType instead.

countryOfActivityCodestring nullable

ISO 3166-1 alpha-2 country of activity code

netWeightInKgnumber required

Net weight in kg

quantitynumber nullable

Quantity

unitstring nullable

Quantity unit

hsCodestring required

HS code

Example response

{
  "id": 123,
  "productId": 201,
  "updatedAt": "2026-01-15T10:30:00Z",
  "referenceNumber": "EU-REF-12345",
  "verificationNumber": "VER-987654",
  "date": "2026-01-15T10:30:00Z",
  "origins": [
    {
      "id": 501,
      "name": "Plot North",
      "active": true,
      "producedAtStart": "2026-01-15T10:30:00Z",
      "producedAtEnd": "2026-01-15T10:30:00Z",
      "countryCode": "AT",
      "plotAreaHa": 1.25,
      "originRequestId": 1001,
      "weight": 12.5,
      "createdAt": "2026-01-15T10:30:00Z",
      "updatedAt": "2026-01-15T10:30:00Z",
      "producerId": 42,
      "assessments": {
        "deforestation": {
          "status": "[\"Negligible\"]"
        },
        "legality": {
          "status": "[\"Negligible\"]"
        }
      }
    }
  ],
  "identifier": {
    "eori": "EU123456789"
  },
  "customerName": "Acme GmbH",
  "customerCity": "Vienna",
  "customerPostalCode": "1010",
  "customerStreet": "Main Street 1",
  "customerCountryCode": "AT",
  "countryOfActivityCode": "AT",
  "netWeightInKg": 1250.75,
  "quantity": 10,
  "unit": "m3",
  "hsCode": "440799"
}

Changes

  • 2a9e4787c6e5Revision changes
    • warning

      added the new permission_limit_not_assigned enum value to the ///// response property for the response status

  • 64e6664ac3e7Revision changes
    • warning

      added the new risk_analysis_migration_blocked enum value to the ///// response property for the response status

    • warning

      added the new risk_analysis_not_legacy enum value to the ///// response property for the response status