Skip to main content

Reference Data Service

Reference data is read-only and changes infrequently. Cache aggressively (TTL: 24h minimum).

GetCountries​

Returns the list of valid country codes accepted in all address and routing fields.

Request​

<GetCountriesRequest>
  <languageId>EN</languageId>   <!-- optional; defaults to EN -->
</GetCountriesRequest>

Response​

<GetCountriesResponse>
  <countries>
    <country>
      <countryId>DE</countryId>
      <name>Germany</name>
    </country>
    <!-- ... -->
  </countries>
</GetCountriesResponse>

GetWasteCodes​

Returns the full EU waste catalogue (EWC codes) and their list identifiers (Annex III, IIIA, IIIB, IV, etc.).

Request​

<GetWasteCodesRequest>
  <wasteList>AnnexIV</wasteList>  <!-- optional filter -->
  <languageId>EN</languageId>
</GetWasteCodesRequest>

Response​

<GetWasteCodesResponse>
  <wasteCodes>
    <entry>
      <wasteTypeCode>160213*</wasteTypeCode>
      <wasteList>AnnexIV</wasteList>
      <description>...</description>
    </entry>
  </wasteCodes>
</GetWasteCodesResponse>

GetCompetentAuthorities​

Returns all registered competent authority (CA) parties with their UUIDs and domain codes.

Request​

<GetCompetentAuthoritiesRequest>
  <countryId>HR</countryId>  <!-- optional filter -->
</GetCompetentAuthoritiesRequest>

Response​

<GetCompetentAuthoritiesResponse>
  <competentAuthorities>
    <ca>
      <partyUUID>xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx</partyUUID>
      <caCode>HR-ENV-01</caCode>
      <countryId>HR</countryId>
      <name>Ministry of Economy and Sustainable Development</name>
    </ca>
  </competentAuthorities>
</GetCompetentAuthoritiesResponse>

GetTransportModes​

Returns valid means-of-transport codes (road, rail, sea, air, inland waterway).

Request​

<GetTransportModesRequest/>

Response​

<GetTransportModesResponse>
  <transportModes>
    <mode>
      <code>T1</code>
      <description>Road</description>
    </mode>
  </transportModes>
</GetTransportModesResponse>

GetRecoveryDisposalCodes​

Returns valid R-codes (recovery) and D-codes (disposal).

Request​

<GetRecoveryDisposalCodesRequest>
  <destinedFor>RECOVERY</destinedFor>  <!-- RECOVERY | DISPOSAL | both if omitted -->
</GetRecoveryDisposalCodesRequest>

Response​

<GetRecoveryDisposalCodesResponse>
  <codes>
    <code>
      <value>R3</value>
      <destinedFor>RECOVERY</destinedFor>
      <description>Recycling/reclamation of organic substances</description>
    </code>
  </codes>
</GetRecoveryDisposalCodesResponse>

GetPhysicalCharacteristicCodes​

Returns valid physical characteristic type codes (solid, liquid, paste, powder, etc.).

GetPackagingCodes​

Returns valid package type codes.

GetAttachmentTypes​

Returns the enumerated list of valid attachment type identifiers. Valid attachment types include values such as AuditReport, FacilityPermit, WasteTreatmentInformation, and others as defined in the DIWASS technical documentation.