DDS Status

DDS Status API

Get DDS Status by Batch External ID

GET /api/v1/integration/dds/:batchExternalId

Returns the DDS (Due Diligence Statement) status for a batch that was synced from your external system.

Required scope: integration:dds:read

Path Parameters

Parameter	Type	Description
`batchExternalId`	string	The external ID of the batch

Response

{
  "batchExternalId": "BATCH-2024-001",
  "batchNumber": "BN-2024-001",
  "internalBatchId": "clx...",
  "product": {
    "id": "clx...",
    "name": "Brazilian Hardwood Planks",
    "hsCode": "4407.29"
  },
  "supplier": {
    "id": "clx...",
    "name": "Amazon Timber Co.",
    "country": "BR"
  },
  "ddsNumber": "DDS-2024-00042",
  "ddsStatus": "SUBMITTED",
  "ddsSubmissions": [
    {
      "id": "clx...",
      "status": "SUBMITTED",
      "ddsNumber": "DDS-2024-00042",
      "submittedAt": "2024-02-01T12:00:00.000Z",
      "createdAt": "2024-01-20T08:00:00.000Z"
    }
  ]
}

Error: Batch Not Found

{
  "error": "NOT_FOUND",
  "message": "No batch found with externalId \"BATCH-UNKNOWN\""
}

DDS Status Values

Status	Description
`DRAFT`	DDS created but not yet submitted
`SUBMITTED`	Submitted to EU TRACES system
`APPROVED`	Approved by competent authority
`REJECTED`	Rejected — requires remediation
`null`	No DDS has been created for this batch