Skip to content
📥 Download as PDF

Echo Service — API Reference

Service: EudrEchoService
Namespace: http://ec.europa.eu/tracesnt/eudr/echo
Endpoint: /tracesnt/ws/eudr/echo
Security: WS-Security (UsernameToken over HTTPS)

Overview

The EUDR Echo Service is a lightweight connectivity test endpoint that allows integrators to verify that their WS-Security credentials and SOAP client configuration are working correctly before attempting to call the main EUDR services (DDS, SD, Verification).

Use this service to confirm:

  • Your UsernameToken (username + authentication key) is valid
  • Your SOAP envelope is correctly formed (timestamp, headers, signature)
  • Your WebServiceClientId header is properly included
  • Network connectivity to the EUDR SOAP infrastructure is established

Note

The EUDR Echo Service is available in the acceptance environment for integration testing. To verify production connectivity, use a real API call with restrictive filters - a successful empty response confirms credentials and network access.

WSDL

Environment WSDL URL
Production https://eudr.webcloud.ec.europa.eu/tracesnt/ws/eudr/echo?wsdl
Acceptance https://acceptance.eudr.webcloud.ec.europa.eu/tracesnt/ws/eudr/echo?wsdl

Operations

testEcho

Send a test query string and receive a status response confirming successful authentication and connectivity.

  • Request: EudrEchoRequest
  • Response: EudrEchoResponse
  • Faults: EudrEchoServiceFault

Request / Response Types

EudrEchoRequest

Field Type Required Description
query xs:string Yes Test parameter — any arbitrary string to echo back

EudrEchoResponse

Field Type Required Description
status xs:string Yes Status of the echo operation confirming successful processing

EudrEchoServiceFault

Field Type Required Description
errorMessage xs:string No Generated error message during process

Authentication

The Echo Service uses the same WS-Security mechanism as all other EUDR services:

  • Transport: HTTPS with TLS
  • Token: UsernameToken with PasswordDigest (hashed)
  • Timestamp: Required (wsu:Created / wsu:Expires)
  • Header: WebServiceClientId - your client identifier from the "Web Services Access" section of your profile

Sample Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:echo="http://ec.europa.eu/tracesnt/eudr/echo"
                  xmlns:base="http://ec.europa.eu/sanco/tracesnt/base/v4">
    <soapenv:Header>
        <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
                       xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
            <wsu:Timestamp>
                <wsu:Created>2026-01-15T10:00:00.000Z</wsu:Created>
                <wsu:Expires>2026-01-15T10:05:00.000Z</wsu:Expires>
            </wsu:Timestamp>
            <wsse:UsernameToken>
                <wsse:Username>your-username</wsse:Username>
                <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordDigest">digest-value</wsse:Password>
                <wsse:Nonce EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary">nonce-value</wsse:Nonce>
                <wsu:Created>2026-01-15T10:00:00.000Z</wsu:Created>
            </wsse:UsernameToken>
        </wsse:Security>
        <base:WebServiceClientId>YOUR_CLIENT_ID</base:WebServiceClientId>
    </soapenv:Header>
    <soapenv:Body>
        <echo:EudrEchoRequest>
            <echo:query>Hello EUDR</echo:query>
        </echo:EudrEchoRequest>
    </soapenv:Body>
</soapenv:Envelope>

Sample Response

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:echo="http://ec.europa.eu/tracesnt/eudr/echo">
    <soapenv:Body>
        <echo:EudrEchoResponse>
            <echo:status>OK</echo:status>
        </echo:EudrEchoResponse>
    </soapenv:Body>
</soapenv:Envelope>

Sample Fault

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:echo="http://ec.europa.eu/tracesnt/eudr/echo">
    <soapenv:Body>
        <soapenv:Fault>
            <faultcode>soapenv:Server</faultcode>
            <faultstring>EudrEchoServiceFault</faultstring>
            <detail>
                <echo:EudrEchoServiceFault>
                    <echo:errorMessage>Authentication failed</echo:errorMessage>
                </echo:EudrEchoServiceFault>
            </detail>
        </soapenv:Fault>
    </soapenv:Body>
</soapenv:Envelope>

Troubleshooting

Symptom Likely Cause Resolution
Authentication failed Invalid username or authentication key Verify credentials in EU Login profile (see Acquiring Credentials)
Timestamp expired Clock skew between client and server Ensure system clock is synchronized (NTP); wsu:Created must be within 5 minutes of server time
Missing WebServiceClientId Header not included in SOAP envelope Add <base:WebServiceClientId> to the SOAP header
Connection timeout Network/firewall issue Verify HTTPS connectivity to the endpoint URL; check proxy settings
Back to top