> For the complete documentation index, see [llms.txt](https://docs.live-eo.com/tradeaware/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.live-eo.com/tradeaware/using-the-tradeaware-api/api-reference/transactions/retrieve-dds-data.md).

# Retrieve DDS Data

Fetch a Due Diligence Statement from the EUDR TRACES system by its reference and verification numbers.

`GET /dds/fetch-dds-data` fetches a Due Diligence Statement (DDS) from the EU's EUDR TRACES system using its reference number and verification number. Use it to check that a DDS exists, and to see what it contains, before you attach it to a transaction component. You can also call it on its own.

TradeAware sends the request to the TRACES environment configured for your business. More info about the EUDR TRACES system: [EUDR information system](https://green-business.ec.europa.eu/deforestation-regulation-implementation/information-system-deforestation-regulation_en).

{% hint style="warning" %}
A `200` response does not always contain the full DDS. When EU TRACES confirms the DDS exists but only shows its content in the TRACES UI, `statement` contains only `status` and `detailsAvailable` is `false`. Check `detailsAvailable` before you read content fields such as `commodities`.
{% endhint %}

## Fetch Due Diligence Statement data from EUDR Traces system

> More info about EUDR Traces system: <https://green-business.ec.europa.eu/deforestation-regulation-implementation/information-system-deforestation-regulation\\_en>

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "TradeAware API",
    "version": "0.59.1"
  },
  "servers": [
    {
      "url": "https://api.tradeaware.live-eo.com"
    }
  ],
  "security": [
    {
      "bearer": []
    }
  ],
  "components": {
    "securitySchemes": {
      "bearer": {
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "type": "http"
      }
    }
  },
  "paths": {
    "/dds/fetch-dds-data": {
      "get": {
        "description": "More info about EUDR Traces system: https://green-business.ec.europa.eu/deforestation-regulation-implementation/information-system-deforestation-regulation_en",
        "operationId": "DdsController_fetchDdsData",
        "parameters": [
          {
            "name": "verificationNumber",
            "required": true,
            "in": "query",
            "description": "The verification number of the DDS",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "referenceNumber",
            "required": true,
            "in": "query",
            "description": "The reference number of the DDS",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The DDS data. `statement.status.status` can be any value from the EudrStatusType set (SUBMITTED, AVAILABLE, REJECTED, WITHDRAWN, ARCHIVED, SUSPENDED, UPDATED, GROUPED, OBSOLETE). `detailsAvailable` is false when EU TRACES confirms the DDS exists but only shows its content in the TRACES UI: `statement` then contains only `status`, so check the flag before reading content fields."
          },
          "400": {
            "description": "Incorrect reference or/and verification number"
          },
          "403": {
            "description": "The business does not have permission to manage transactions"
          },
          "429": {
            "description": "Too many requests - Limit: 2 requests per 10 seconds"
          },
          "503": {
            "description": "The DDS data could not be fetched from EUDR Traces system"
          }
        },
        "summary": "Fetch Due Diligence Statement data from EUDR Traces system",
        "tags": [
          "DDS"
        ]
      }
    }
  }
}
```

## Requirements

* **Authentication:** a bearer token (JWT) in the `Authorization` header.
* **Entitlement:** your business's plan must include managing transactions.
* **Rate limit:** 2 requests every 10 seconds.

## Example responses

<details>

<summary>200 OK: full statement (detailsAvailable: true)</summary>

```json
{
  "statement": {
    "activityType": "IMPORT",
    "representedOperator": {
      "operatorAddress": {
        "country": "DE",
        "street": "CONFIDENTIAL",
        "postalCode": "CONFIDENTIAL",
        "city": "CONFIDENTIAL"
      },
      "operatorName": "one nam"
    },
    "commodities": [
      {
        "position": 1,
        "descriptors": {
          "descriptionOfGoods": "Coffee, whether or not roasted or decaffeinated; coffee husks and skins; coffee substitutes containing coffee in any proportion",
          "goodsMeasure": {
            "netWeight": "12.000000"
          }
        },
        "hsHeading": "0901",
        "producers": [
          {
            "country": "ID",
            "geometryGeojson": "<base64-encoded GeoJSON FeatureCollection>"
          },
          {
            "country": "EE",
            "geometryGeojson": "<base64-encoded GeoJSON FeatureCollection>"
          }
        ]
      }
    ],
    "geoLocationConfidential": false,
    "status": {
      "status": "AVAILABLE",
      "date": "2026-10-28T16:03:38.483Z"
    }
  },
  "detailsAvailable": true
}
```

</details>

<details>

<summary>200 OK: status only (detailsAvailable: false)</summary>

```json
{
  "statement": {
    "status": {
      "status": "AVAILABLE",
      "date": "2026-10-28T16:03:38.483Z"
    }
  },
  "detailsAvailable": false
}
```

</details>

## Response notes

* `detailsAvailable` tells you what `statement` contains:
  * `true`: the full DDS content from EU TRACES, plus `status`.
  * `false`: EU TRACES confirmed the DDS exists but only shows its content in the TRACES UI. `statement` contains only `status` (`status` and `date`); content fields such as `activityType`, `representedOperator`, `commodities` and `geoLocationConfidential` are absent. To see the content, open the DDS in the TRACES UI.
* `status.status` is the DDS status from EU TRACES, for example `AVAILABLE` or `WITHDRAWN`. `status` and `date` can be `null` when TRACES does not return them.
* Each entry in `producers` has a `geometryGeojson` field. It holds a **base64-encoded** GeoJSON `FeatureCollection`, so decode it before use.
* Operator address fields can come back as `CONFIDENTIAL` when the operator has withheld them.
* `geoLocationConfidential` shows whether the DDS owner has marked the geolocation as confidential.

## Errors

* `400`: no DDS exists in EU TRACES for this reference and verification number.
* `503`: EU TRACES could not be reached, or it could not confirm whether the DDS exists. Retry later.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.live-eo.com/tradeaware/using-the-tradeaware-api/api-reference/transactions/retrieve-dds-data.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
