# Abonnement

Tinglysningsretten
1.0.0

← Back to Main Page

## Overview

e-TL allows you to subscribe to events on a specific property via the System-System interface.

When an event occurs, the subscriber receives a message that contains a minimum of information that allows the subscriber to identify the event.

Access to information in the land register is subject to tax and the subscriber scheme is designed as follows, so that no information is handed in that would otherwise trigger a tax.

When subscribing to a property, all incidents on the property are received. The subscriber himself is responsible for sorting out any uninteresting events.

Subscription events are received via the SubscriptionAnswer response service. See the SubscriptionAnswer documentation for detailed event structure information.

Via the system-system interface, it is only possible to manage subscriptions that result in system-system notifications.

All calls are asynchronous and trigger a notification.

### Endpoints

#### AbonnementOpret

Endpoint URL: `Abonnement/AbonnementOpret`

Description | Subscribe to a single property. In response, you receive a Subscription Identifier that can be used for subsequent administration of the subscription. For notifications about incidents on the property, the subscription identifier is sent.
Input | AbonnementOpret.xsd
Output | AbonnementOpretSvar.xsd
Error handling | If errors occur, e.g. if the property does not exist, then e-TL sends a XML error. If the subscription already exists, the call has no effect.
Interaction pattern | Query response

Example request:

    POST /s2s/Abonnement/AbonnementOpret HTTP/1.1
    Content-Type: application/xml
    Tinglysning-Message-ID: uuid:332195c5-e74a-4b42-83f8-a5d9d7f5e576
    Tinglysning-Relates-To: s2s-http-xml-api-end2end-test
    Content-Length: 4342

    <?xml version="1.0" encoding="UTF-8"?><AbonnementOpret xmlns="http://rep.oio.dk/tinglysning.dk/service/message/administration/1/" xmlns:ns="http://rep.oio.dk/tinglysning.dk/schema/model/1/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://rep.oio.dk/tinglysning.dk/service/message/administration/1/ http://rep.oio.dk/tinglysning.dk/service/message/administration/1/AbonnementOpret.xsd">
        <ns:BilIdentifikator>
            <ns:Stelnummer>WAUZZZ8EX7A263972</ns:Stelnummer>
        </ns:BilIdentifikator>
    <Signature xmlns="http://www.w3.org/2000/09/xmldsig#" Id="Signature-573e2f04-4956-4094-a7e5-c06a5e8e0179"><SignedInfo><CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/><SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#rsa-sha512"/><Reference URI=""><Transforms><Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/><Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/></Transforms><DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/><DigestValue>e3Azsb/DuCoOM13NvPtVjuUaWtcBNLsINSCKXP68wzQ=</DigestValue></Reference></SignedInfo><SignatureValue>kVFQ6FFl6LnT3bFlolQ9ii5HJIY7MdhAq5XUZ9OfN+qaJ/kDmzqPaaW1yfmZv2sSQ1M7nQhi37W0&#13;
    QreTsvN8oh0Bxt2RUvkVImOIlj0WXGc6p7x3RmpnLN/oNNeykvrKhXFA+in2gGhnTShGM6IhObgu&#13;
    NNFMsjQm+uwDWL6YabYBrQhzpJtQhhDIasUcoWzEszsDevu2ZqUcXs44B/AgI90eIPx8NP3Dr+mO&#13;
    7nk2oNV5/onhoV/4CrmrTFbv7JAMDvTq7tkSYT7CMiYsheyNaP3qmnYWVzTBMnGDB46YDH9+N9W8&#13;
    0R0iNKbTD7xwXNUkQVtEqyPH9AH1evIb22SgAWxPvAcF6lV2oXcSxL8/4B0hiKEAktSqUpLRcX72&#13;
    NSIvZn16p3DtIApgWmdE1Ua8qLG4nb/k2cNv6n0h3Z3fww3Z9b5fkLrkVZEKQSoN6Nx6DuRBD+uK&#13;
    gsrkVtDTwaYBJK+fSSTGAdSVm3BoomQZ9+MpJbVmHDKgVScbi++LmnU2</SignatureValue><KeyInfo><X509Data><X509Certificate>MIIGrDCCBOCgAwIBAgIUNDToBwFCKjTnfoTggwRZQ7NT70wwQQYJKoZIhvcNAQEKMDSgDzANBglg&#13;
    hkgBZQMEAgEFAKEcMBoGCSqGSIb3DQEBCDANBglghkgBZQMEAgEFAKIDAgEgMGsxLTArBgNVBAMM&#13;
    JERlbiBEYW5za2UgU3RhdCBPQ0VTIHVkc3RlZGVuZGUtQ0EgMTETMBEGA1UECwwKVGVzdCAtIGN0&#13;
    aTEYMBYGA1UECgwPRGVuIERhbnNrZSBTdGF0MQswCQYDVQQGEwJESzAeFw0yMzAzMDgxMzEzMDNa&#13;
    Fw0yNjAzMDcxMzEzMDJaMIGiMSUwIwYDVQQDDBxUTFIgZVRMIFRFU1QgLSBYTUwtc2lnbmVyaW5n&#13;
    MTcwNQYDVQQFEy5VSTpESy1POkc6ODg3YTFlNjktNGU4NC00NmI1LWI2NTQtMzgxYzcxYmU4NTU5&#13;
    MRowGAYDVQQKDBFEb21zdG9sc3N0eXJlbHNlbjEXMBUGA1UEYQwOTlRSREstMjE2NTk1MDkxCzAJ&#13;
    BgNVBAYTAkRLMIIBojANBgkqhkiG9w0BAQEFAAOCAY8AMIIBigKCAYEAvfks1Cq2hW2c7fmx2rUW&#13;
    oPgHdSNphG7GWO7GrRkVQSCB3GBzdf7qck56obK0XLui8yD00FDHJgyFCSLIOpesAi9fjQnc+Wl1&#13;
    HUx1WfzPzvGbQvGPB9oWtP1lhY9gNxb3ZObzrW3DfOGbKbbNCw6yaaac5ssi/T447Eg/psHnAACG&#13;
    cGCU9OxsBoTgx5Zq+4k1u+I3mpvGeczetzY6fpQyKzpc1NJNhe6UeKZFxYocWDrIvdoMsOlosI9Q&#13;
    +491FnmKj3heCSMGu8o59uhYw2CpwVDreXYK+tfRj1tZWGhj++uYHmA+SgV9qnw+1DvESZZdPPvX&#13;
    IFuHFJZ2SCO2ZOarvX2IrsjHfyLq1zi80fXS1SHeuIZOJwMclQ6uVrn5VYAzCRr/LPEEOptKsLRK&#13;
    m2q81vHcC2eEXq1IaTIhp4tFJyBsSp/JX0bvM23c4AaLnG1WeT1hAWB8oPUKP/Ai3cesn9VOLcv4&#13;
    Fm72jggT/YuS1dpEL6mgGqID3RVEW1t/0DHNAgMBAAGjggGmMIIBojAMBgNVHRMBAf8EAjAAMB8G&#13;
    A1UdIwQYMBaAFH8on9lxmULidefXNXYuTQglbXZeMHsGCCsGAQUFBwEBBG8wbTBDBggrBgEFBQcw&#13;
    AoY3aHR0cDovL2NhMS5jdGktZ292LmRrL29jZXMvaXNzdWluZy8xL2NhY2VydC9pc3N1aW5nLmNl&#13;
    cjAmBggrBgEFBQcwAYYaaHR0cDovL2NhMS5jdGktZ292LmRrL29jc3AwHgYDVR0RBBcwFYETZS10&#13;
    bC0wMTFAZG9tc3RvbC5kazAhBgNVHSAEGjAYMAgGBgQAj3oBATAMBgoqgVCBKQEBAQMHMDsGCCsG&#13;
    AQUFBwEDBC8wLTArBggrBgEFBQcLAjAfBgcEAIvsSQECMBSGEmh0dHBzOi8vdWlkLmdvdi5kazBF&#13;
    BgNVHR8EPjA8MDqgOKA2hjRodHRwOi8vY2ExLmN0aS1nb3YuZGsvb2Nlcy9pc3N1aW5nLzEvY3Js&#13;
    L2lzc3VpbmcuY3JsMB0GA1UdDgQWBBSVkuXJb5Td054/T6F0sIbTJm7MkjAOBgNVHQ8BAf8EBAMC&#13;
    BeAwQQYJKoZIhvcNAQEKMDSgDzANBglghkgBZQMEAgEFAKEcMBoGCSqGSIb3DQEBCDANBglghkgB&#13;
    ZQMEAgEFAKIDAgEgA4IBgQAJKLA11RSpBE+UO2iLl06PlMPOARixoU/3HPqGBPY0YRZvJ0iCUhMx&#13;
    vw/D/vlrk7wh37vkNLLrakau3d9Dcgkh2UUT9JBGy3JzFXQzOjrvaRfWCkY0jIZz945IgqEPjLXo&#13;
    7x+4e9FybtchHLdzkeg+O/n2uYezp8vkAUQJkJOWVQRZngKCADBdhfnqY/PYEO8S38QBMiS0ZWfC&#13;
    Ip+lrFCuKwOVgHZG16+KcSC6shbYYOurvsii6MAE0mFyCnpVmN4wtlbXaxsEreyQ2b2yTTocw24w&#13;
    Po0QBSPVH+wSfE7lQNHxJVEuFBcYUHhtWjhhYWnINmoBVWclZBAYE18m35vm/zrOyLzuYv79vTY/&#13;
    x1J/hPbsgos9D38Dj6Oc7m9BBuQhfS5bKU2ZsUINQgnypMveltm/6Qxc5cDTlrQp6c7/kxBcJTH3&#13;
    5qC4jIvaIB8v5npfpHCqaVPRj1LX6dFMB1dujqv9ME8yUVOTUHT8RPO/kgsxOdzhvBYRGmCU/7co&#13;
    vZk=</X509Certificate></X509Data></KeyInfo></Signature></AbonnementOpret>

Example response:

    HTTP/1.1 200 OK

    <ns:AbonnementOpretSvar xmlns:ns="http://rep.oio.dk/tinglysning.dk/service/message/administration/1/" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:dsigModel="http://rep.oio.dk/tinglysning.dk/schema/model/1/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://rep.oio.dk/tinglysning.dk/service/message/administration/1/ http://rep.oio.dk/tinglysning.dk/service/message/administration/1/AbonnementOpretSvar.xsd"><ns1:AbonnementIdentifikator xmlns:ns1="http://rep.oio.dk/tinglysning.dk/schema/anmeldelse/1/">beb1d882-83bd-4e4f-bd01-921037113e46</ns1:AbonnementIdentifikator><Signature xmlns="http://www.w3.org/2000/09/xmldsig#" Id="ID25858289830701-ReplySignature"><SignedInfo Id="ID25858289830702-ReplySignatureInfo"><CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/><SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/><Reference URI=""><Transforms><Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/><Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/></Transforms><DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/><DigestValue>1ctv01VEhvbYp4r8XsemQXD36UM=</DigestValue></Reference><Reference Type="http://www.w3.org/2000/09/xmldsig#SignatureProperties" URI="#ID25858289830704-ReplySignatureProperty"><Transforms><Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/></Transforms><DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/><DigestValue>K8ghEBEwah+2xfWWxYE6os52c9k=</DigestValue></Reference></SignedInfo><SignatureValue> </SignatureValue><KeyInfo><X509Data><X509Certificate> </X509Certificate></X509Data></KeyInfo><Object Id="ID25858289830703-ReplySignatureObject"><SignatureProperties><SignatureProperty Id="ID25858289830704-ReplySignatureProperty" Target="#ID25858289830701-ReplySignature"><dsigModel:UnderskriftTidspunkt>2025-10-31T15:23:58</dsigModel:UnderskriftTidspunkt></SignatureProperty></SignatureProperties></Object></Signature></ns:AbonnementOpretSvar>

#### AbonnementSlet

Endpoint URL: `Abonnement/AbonnementSlet`

Description | Deletes the subscription to a single property. In response, you receive information that the subscription is inactive.
Input | AbonnementSlet.xsd
Output | AbonnementSletSvar.xsd
Error handling | If errors occur, e.g. if the property does not exist, then e-TL sends a XML error. If the subscription already exists, the call has no effect.
Interaction pattern | Query response

#### AbonnementStatus

Endpoint URL: `Abonnement/AbonnementStatus`

Description | Retrieves the status of a property subscription. Returns subscription details including whether the subscription exists. If the subscription is found, the date of creation is returned.
Input | AbonnementStatus.xsd
Output | AbonnementStatusSvar.xsd
Error handling |
Interaction pattern | Query response