Overview

This section describes the available REST endpoints for searching company information and retrieving metadata about document types and roles.

The main search functionality allows searching for documents related to a company using CVR number with various filters. Additional endpoints provide lists of available document types and role types for use in searches.

Endpoints

SoegVirksomhedCvr

Endpoint URL: soegvirksomhed/cvr

Method

GET

Description

Search for documents related to a company using CVR number with optional filters for document type, role, date range, and pagination.

Input

Query parameters:

  • cvr - CVR number (required)

  • bog - Registry book number (1=Real Estate, 2=Vehicles, 3=Cooperative Housing, 4=Personal Property) (optional)

  • doktype - Document type (optional, default: 'Pantebrev'). See GetDokumenttyper.

  • rolle - Role type (optional). See GetRolletyper.

  • datofra - From date (optional)

  • datotil - To date (optional)

  • sidetal - Page number for pagination (default: 1)

  • antal - Number of results per page (default: 25)

Output

JSON response containing matching documents with company information.

Error handling

Standard HTTP error codes for invalid input or lack of access.

Interaction pattern

Query response

Example request:

GET /soegvirksomhed/cvr?cvr=15231599&bog=1&doktype=Adkomst&rolle=debitor&datofra=01012000&datotil=01012020&sidetal=1&antal=25 HTTP/1.1
accept: */*

Example response:

{
  "VirksomhedSoegResultat": {
    "VirksomhedSoegningInformationSamling": [
      {
        "CVRnumberIdentifier": "15231599",
        "EjendomIdentifikator": {
          "BestemtFastEjendomNummer": "5308963",
          "Matrikel": [
            {
              "CadastralDistrictName": "Vestermarken, Roskilde Jorder",
              "CadastralDistrictIdentifier": "2000355",
              "Matrikelnummer": "0020li"
            }
          ]
        },
        "RolleTypeIdentifikator": "debitor",
        "JurisdictionCode": "0018",
        "DokumentRettighedSamling": [
          {
            "DokumentRevisionIdentifikator": {
              "DokumentIdentifikator": "f341ea7a-94e2-4f67-adda-b539ed49268c",
              "RevisionNummer": "2"
            },
            "DokumentAlias": {
              "DokumentAliasIdentifikator": "20130905-1000006377"
            },
            "RettighedSamling": [
              {
                "Pantrettighed": {
                  "RettighedIdentifikator": "2047e844-a6b9-421a-8673-4cb0af6f850f",
                  "PrioritetNummer": "15"
                }
              }
            ],
            "HaeftelseType": "privatPantebrev"
          }
        ]
      },
      {
        "CVRnumberIdentifier": "15231599",
        "EjendomIdentifikator": {
          "BestemtFastEjendomNummer": "5308963",
          "Matrikel": [
            {
              "CadastralDistrictName": "Vestermarken, Roskilde Jorder",
              "CadastralDistrictIdentifier": "2000355",
              "Matrikelnummer": "0020li"
            }
          ]
        },
        "RolleTypeIdentifikator": "debitor",
        "JurisdictionCode": "0018",
        "DokumentRettighedSamling": [
          {
            "DokumentRevisionIdentifikator": {
              "DokumentIdentifikator": "cd2ec8b9-a179-439e-acec-a445c418702b",
              "RevisionNummer": "3"
            },
            "DokumentAlias": {
              "DokumentAliasIdentifikator": "20130905-1000006377"
            },
            "RettighedSamling": [
              {
                "Pantrettighed": {
                  "RettighedIdentifikator": "821f8b67-925c-4f64-8d29-9630c230eaf6",
                  "PrioritetNummer": "17"
                }
              }
            ],
            "HaeftelseType": "privatPantebrev"
          }
        ]
      }
    ]
  }
}

GetDokumenttyper

Endpoint URL: soegvirksomhed/dokumenttyper

Method

GET

Description

Retrieve a list of available document types that can be used in company searches.

Input

None

Output

JSON response containing a list of document types with key-value pairs and registry book numbers.

Error handling

Standard HTTP error codes for lack of access.

Interaction pattern

Query response

Example request:

GET /soegvirksomhed/dokumenttyper HTTP/1.1
accept: */*

Example response:

{
    "1": [
        {
            "val": "Anden hæftelse",
            "key": "anden"
        },
        {
            "val": "Arrest",
            "key": "arrest"
        },
        {
            "val": "Ejerpantebrev",
            "key": "ejerpantebrev"
        },
        {
            "val": "Indekspantebrev",
            "key": "privatIndekspantebrev"
        },
        {
            "val": "Pantebrev",
            "key": "privatPantebrev"
        },
        {
            "val": "Realkreditpantebrev",
            "key": "realkreditpantebrev"
        },
        {
            "val": "Skadesløsbrev",
            "key": "skadesloesbrev"
        },
        {
            "val": "Udlæg",
            "key": "udlaeg"
        },
        {
            "val": "Underpant",
            "key": "underpant"
        },
        {
            "val": "Anden adkomst",
            "key": "andenAdkomst"
        },
        {
            "val": "Auktionsskøde",
            "key": "auktionsskoede"
        },
        {
            "val": "Betinget skøde",
            "key": "skoedeBetinget"
        },
        {
            "val": "Bodelingsoverenskomst",
            "key": "bodelingsoverenskomst"
        },
        {
            "val": "Ejendomsdom",
            "key": "ejendomsdom"
        },
        {
            "val": "Skifteretsattest",
            "key": "skifteretsattest"
        },
        {
            "val": "Endeligt skøde",
            "key": "skoede"
        },
        {
            "val": "Ægtepagt",
            "key": "aegtepagt"
        },
        {
            "val": "Servitut",
            "key": "andenServitut"
        },
        {
            "val": "Ekspropriation foreløbig",
            "key": "ekspropriationForeloebig"
        },
        {
            "val": "Forpagtningskontrakt",
            "key": "forpagtningskontrakt"
        },
        {
            "val": "Jordfordeling foreløbig",
            "key": "jordfordelingForeloebig"
        },
        {
            "val": "Lejekontrakt",
            "key": "lejekontrakt"
        },
        {
            "val": "Salgs og pantsætningsforbud",
            "key": "salgsOgPantsaetningsforbud"
        },
        {
            "val": "Samejeoverenskomst",
            "key": "samejeoverenskomst"
        },
        {
            "val": "Vedtægter",
            "key": "vedtaegter"
        }
    ],
    "2": [
        {
            "val": "Arrest",
            "key": "arrest"
        },
        {
            "val": "Ejerpantebrev",
            "key": "ejerpantebrev"
        },
        {
            "val": "Pantebrev",
            "key": "privatPantebrev"
        },
        {
            "val": "Skadesløsbrev",
            "key": "skadesloesbrev"
        },
        {
            "val": "Udlæg",
            "key": "udlaeg"
        },
        {
            "val": "Ejendomsforbehold",
            "key": "ejendomsforbehold"
        }
    ],
    "3": [
        {
            "val": "Arrest",
            "key": "arrest"
        },
        {
            "val": "Ejerpantebrev",
            "key": "ejerpantebrev"
        },
        {
            "val": "Pantebrev",
            "key": "privatPantebrev"
        },
        {
            "val": "Skadesløsbrev",
            "key": "skadesloesbrev"
        },
        {
            "val": "Udlæg",
            "key": "udlaeg"
        }
    ],
    "4": [
        {
            "val": "Ejerpantebrev",
            "key": "ejerpantebrev"
        },
        {
            "val": "Pantebrev",
            "key": "privatPantebrev"
        },
        {
            "val": "Skadesløsbrev",
            "key": "skadesloesbrev"
        },
        {
            "val": "Høstpantebrev",
            "key": "hoestpantebrev"
        }
    ]
}

GetRolletyper

Endpoint URL: soegvirksomhed/rolletyper

Method

GET

Description

Retrieve a list of available role types that can be used in company searches.

Input

None

Output

JSON response containing a list of role types with key-value pairs.

Error handling

Standard HTTP error codes for lack of access.

Interaction pattern

Query response

Example request:

GET /soegvirksomhed/rolletyper HTTP/1.1
accept: */*

Example response:

{
    "1": [
        {
            "val": "Debitor",
            "key": "debitor"
        },
        {
            "val": "Ejer",
            "key": "ejer"
        },
        {
            "val": "Kreditor",
            "key": "kreditor"
        },
        {
            "val": "Påtaleberettiget",
            "key": "paataleberettiget"
        },
        {
            "val": "Underpanthaver",
            "key": "underpanthaver"
        }
    ],
    "2": [
        {
            "val": "Debitor",
            "key": "debitor"
        },
        {
            "val": "Kreditor",
            "key": "kreditor"
        },
        {
            "val": "Underpanthaver",
            "key": "underpanthaver"
        }
    ],
    "3": [
        {
            "val": "Debitor",
            "key": "debitor"
        },
        {
            "val": "Kreditor",
            "key": "kreditor"
        },
        {
            "val": "Underpanthaver",
            "key": "underpanthaver"
        }
    ],
    "4": [
        {
            "val": "Debitor",
            "key": "debitor"
        },
        {
            "val": "Kreditor",
            "key": "kreditor"
        },
        {
            "val": "Underpanthaver",
            "key": "underpanthaver"
        }
    ]
}

HarRegistreringer

Endpoint URL: soegvirksomhed/registreringer

Method

GET

Description

Check if a company has any registrations in the system. Can optionally return the result as a PDF document.

Input

Query parameters:

  • cvr - CVR number (required)

  • sompdf - Return as PDF document (default: false)

Output

JSON response indicating whether registrations exist, or PDF document if sompdf=true.

Error handling

Standard HTTP error codes for invalid input or lack of access.

Interaction pattern

Query response

Example request:

GET /soegvirksomhed/registreringer?cvr=15231599&somPdf=false HTTP/1.1
accept: */*

Example response:

{
    "harRegistreringer": true,
    "linkTxt": "domstol.dk/tinglysningsretten/kontakt/",
    "string1": "F.s.v. angår virksomheden med cvr-nr. 15231599 kan der være - eller kan der have været - registreret virksomhedspant. ",
    "string2": "Kontakt Tinglysningsretten på domstol.dk/tinglysningsretten/kontakt/ ",
    "string3": "for yderligere oplysninger."
}