Skip to main content

Operator Service

Operators are registered in DIWASS by competent authorities. Commercial software reads operator data; it does not create operators.

GetOperators​

Retrieves all operators associated with the authenticated commercial software's domain. Used during initial sync and delta sync.

Request​

<GetOperatorsRequest>
  <userCADomainId>YOUR-CADOMAIN-ID</userCADomainId>
  <modifiedSince>2026-01-01T00:00:00Z</modifiedSince>  <!-- optional, for delta sync -->
</GetOperatorsRequest>

Response​

<GetOperatorsResponse>
  <operators>
    <operator>
      <operatorInternalID>OP-12345</operatorInternalID>
      <partyUUID>xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx</partyUUID>
      <name>Waste Handler GmbH</name>
      <identifiers>
        <identifier>
          <type>VAT</type>
          <name>VAT number</name>
          <value>DE123456789</value>
          <isMain>true</isMain>
        </identifier>
      </identifiers>
      <address>
        <street>Musterstraße 1</street>
        <cityName>Berlin</cityName>
        <postalCode>10115</postalCode>
        <countryId>DE</countryId>
      </address>
      <contact>
        <phone>+49301234567</phone>
        <personName>Max Mustermann</personName>
        <email>max@example.de</email>
      </contact>
      <activity>
        <internalID>ACT-001</internalID>
        <chapterName>Annex IV</chapterName>
        <sectionName>3</sectionName>
        <typeName>waste_operator</typeName>
        <status>active</status>
        <responsibleAuthorityActivityCode>DE-ENV-NRW</responsibleAuthorityActivityCode>
      </activity>
      <linkedOperatorInternalID>OP-99999</linkedOperatorInternalID>
    </operator>
  </operators>
</GetOperatorsResponse>

GetOperator​

Retrieves a single operator by their DIWASS internal ID.

Request​

<GetOperatorRequest>
  <operatorInternalID>OP-12345</operatorInternalID>
</GetOperatorRequest>

Response​

Same shape as a single <operator> element from GetOperators.