### GraphQL Query with Variables Example

Source: https://confluence.sdfi.dk/display/DML/Udvalgte+REST-tjenester+omsat+til+GraphQL-queries/index

This section demonstrates how to use variables in GraphQL queries to create more dynamic and automated calls. It includes an example query and its corresponding variables.

```APIDOC
## GraphQL Query with Variables

### Description
This example shows how to use variables in a GraphQL query. A CPR number is passed as a variable to query for private sector person information.

### Method
POST (typically, for GraphQL queries)

### Endpoint
(Depends on the GraphQL client/server setup, e.g., /graphql)

### Parameters
#### Query Parameters
None

#### Request Body
##### Query
```graphql
query ($input: PrivateSectorPersonInput) {
   CPRCustom_PrivateSectorPerson (input: $input) {
     personnumre {
       personnummer
       status
     }
     beskyttelser {
       beskyttelsestype
       status
       virkningfra
     }
   }
 }
```

##### Variables
```json
{
  "input": {
    "pnr": "0101011234"
  }
}
```

### Request Example
(Combined Query and Variables, often sent in a single request payload)
```json
{
  "query": "\nquery ($input: PrivateSectorPersonInput) {\n   CPRCustom_PrivateSectorPerson (input: $input) {\n     personnumre {\n       personnummer\n       status\n     }\n     beskyttelser {\n       beskyttelsestype\n       status\n       virkningfra\n     }\n   }\n }",
  "variables": {
    "input": {
      "pnr": "0101011234"
    }
  }
}
```

### Response
#### Success Response (200)
- **data** (object) - Contains the result of the GraphQL query.
  - **CPRCustom_PrivateSectorPerson** (object) - Information about the private sector person.
    - **personnumre** (array) - List of person numbers.
      - **personnummer** (string) - The person's number.
      - **status** (string) - The status of the person number.
    - **beskyttelser** (array) - List of protections.
      - **beskyttelsestype** (string) - The type of protection.
      - **status** (string) - The status of the protection.
      - **virkningfra** (string) - The effective date from.

#### Response Example
```json
{
  "data": {
    "CPRCustom_PrivateSectorPerson": {
      "personnumre": [
        {
          "personnummer": "0101011234",
          "status": "Active"
        }
      ],
      "beskyttelser": [
        {
          "beskyttelsestype": "TypeA",
          "status": "Enabled",
          "virkningfra": "2023-01-01T00:00:00Z"
        }
      ]
    }
  }
}
```
```

--------------------------------

### GraphQL Variables Example

Source: https://confluence.sdfi.dk/display/DML/Udvalgte+REST-tjenester+omsat+til+GraphQL-queries/display/DML/Udvalgte%2BREST-tjenester%2Bomsat%2Btil%2BGraphQL-queries

Demonstrates how to use variables in GraphQL queries for dynamic data fetching. This example shows a query for private sector person data using a CPR number provided via variables.

```APIDOC
## GraphQL Query with Variables

### Description
This section illustrates the use of variables in GraphQL queries to make them more dynamic and automated. It shows a query that accepts an input variable for fetching private sector person details.

### Method
POST (typically for GraphQL queries)

### Endpoint
(Not specified, assumed to be a GraphQL endpoint)

### Parameters
#### Query Variables
- **input** (PrivateSectorPersonInput) - Required - An input object containing parameters for the query, such as 'pnr'.

### Request Example (Query)
```graphql
query ($input: PrivateSectorPersonInput) {
   CPRCustom_PrivateSectorPerson (input: $input) {
     personnumre {
       personnummer
       status
     }
     beskyttelser {
       beskyttelsestype
       status
       virkningfra
     }
   }
 }
```

### Request Example (Variables)
```json
{
  "input": {
    "pnr": "0101011234"
  }
}
```

### Response
#### Success Response (200)
- **CPRCustom_PrivateSectorPerson** (object) - Contains details about the private sector person, including person numbers and protections.
  - **personnumre** (array) - List of person numbers and their statuses.
  - **beskyttelser** (array) - List of protections, their types, statuses, and validity periods.

#### Response Example
(Example response structure would depend on the actual data returned by the API)
```

--------------------------------

### EJF - Ejerskabsskifte

Source: https://confluence.sdfi.dk/display/DML/Udvalgte+REST-tjenester+omsat+til+GraphQL-queries/display/DML/Udvalgte%2BREST-tjenester%2Bomsat%2Btil%2BGraphQL-queries

Examples of GraphQL queries for EJF ownership changes, demonstrating the translation from REST services.

```APIDOC
## POST /graphql

### Description
GraphQL query to retrieve information about EJF ownership changes.

### Method
POST

### Endpoint
/graphql

### Parameters
#### Query Parameters
None

#### Request Body
- **query** (String) - Required - The GraphQL query string.
- **variables** (Object) - Optional - Variables for the GraphQL query.

### Request Example
```json
{
  "query": "\n    query Ejerskabsskifte($cprNummer: String!) {\n      EJF {\n        Ejerskabsskifte(cprNummer: $cprNummer) {\n          ...EjerskabsskifteFields\n        }\n      }\n    }\n\n    fragment EjerskabsskifteFields on EJFEjerskabsskifte {\n      FoedselsDato\n      Navn\n      Adresse\n      Postnr\n      PostnrNavn\n      Status\n      RegistreringsDato\n      VirksomhedsNavn\n      CVRNummer\n      FoedselsDato\n      Navn\n      Adresse\n      Postnr\n      PostnrNavn\n      Status\n      RegistreringsDato\n      VirksomhedsNavn\n      CVRNummer\n    }\n  ",
  "variables": {
    "cprNummer": "123456-7890"
  }
}
```

### Response
#### Success Response (200)
- **data** (Object) - Contains the result of the GraphQL query.
  - **EJF** (Object)
    - **Ejerskabsskifte** (Array) - List of ownership change records.
      - **FoedselsDato** (String) - Date of birth.
      - **Navn** (String) - Name.
      - **Adresse** (String) - Address.
      - **Postnr** (String) - Postal code.
      - **PostnrNavn** (String) - Postal town name.
      - **Status** (String) - Status.
      - **RegistreringsDato** (String) - Registration date.
      - **VirksomhedsNavn** (String) - Company name.
      - **CVRNummer** (String) - CVR number.

#### Response Example
```json
{
  "data": {
    "EJF": {
      "Ejerskabsskifte": [
        {
          "FoedselsDato": "1980-01-01",
          "Navn": "Test Navn",
          "Adresse": "Test Adresse 1",
          "Postnr": "1000",
          "PostnrNavn": "København K",
          "Status": "Aktiv",
          "RegistreringsDato": "2020-01-01",
          "VirksomhedsNavn": "Test Virksomhed",
          "CVRNummer": "12345678"
        }
      ]
    }
  }
}
```
```

--------------------------------

### GraphQL Query with Variables

Source: https://confluence.sdfi.dk/display/DML/Udvalgte+REST-tjenester+omsat+til+GraphQL-queries/display/DML/Udvalgte%2BREST-tjenester%2Bomsat%2Btil%2BGraphQL-queries

Demonstrates how to use variables in a GraphQL query to dynamically pass input parameters. This allows for more flexible and automated API calls. The example shows a query for CPRCustom_PrivateSectorPerson using an input variable.

```graphql
query ($input: PrivateSectorPersonInput) {
   CPRCustom_PrivateSectorPerson (input: $input) {
     personnumre {
       personnummer
       status
     }
     beskyttelser {
       beskyttelsestype
       status
       virkningfra
     }
   }
 }
```

```json
{
  "input": {
    "pnr": "0101011234"
  }
}
```

--------------------------------

### Fetch Building Entrance Data (GraphQL)

Source: https://confluence.sdfi.dk/display/DML/Udvalgte+REST-tjenester+omsat+til+GraphQL-queries/display/DML/Udvalgte%2BREST-tjenester%2Bomsat%2Btil%2BGraphQL-queries

This GraphQL query retrieves details about building entrances, including access information and elevator status. It employs pagination for efficient data retrieval.

```graphql
bygningOpgang(first: 10) {
  pageInfo {
    hasNextPage
    endCursor
  }
  nodes {
    adgangFraHusnummer
    bygning
    datafordelerOpdateringstid
    datafordelerRegisterImportSequenceNumber
    datafordelerRowId
    datafordelerRowVersion
    forretningshaendelse
    forretningsomraade
    forretningsproces
    id_lokalId
    id_namespace
    kommunekode
    opg020Elevator
    opg021HusnummerFunktion
    opg500Notatlinjer
    registreringFra
    registreringsaktoer
    registreringTil
    status
    virkningFra
    virkningsaktoer
    virkningTil
  }
}
```

--------------------------------

### MAT_MatrikulaerSag - Ejerlejlighed

Source: https://confluence.sdfi.dk/display/DML/Udvalgte+REST-tjenester+omsat+til+GraphQL-queries/index

This query retrieves MatrikulaerSag data starting from the Ejerlejlighed entity. It requires 'registreringstid' and 'virkningstid' as input parameters and filters by 'id_lokalId'.

```APIDOC
## MAT_MatrikulaerSag - Ejerlejlighed

### Description
Retrieves MatrikulaerSag data with a focus on related Ejerlejlighed entities. Requires registration and effect times, and filters by a local ID.

### Method
POST

### Endpoint
/graphql

### Parameters
#### Query Parameters
- **registreringstid** (String) - Required - The registration time for the query.
- **virkningstid** (String) - Required - The effect time for the query.

#### Request Body
- **query** (String) - Required - The GraphQL query string.
- **variables** (Object) - Optional - Variables for the query.
  - **where.id_lokalId.eq** (String) - Required - The local ID to filter by.

### Request Example
```json
{
  "query": "query ($registreringstid: String!, $virkningstid: String!, $id_lokalId: String!) { MAT_MatrikulaerSag(first: 1, registreringstid: $registreringstid, virkningstid: $virkningstid, where: { id_lokalId: { eq: $id_lokalId } }) { pageInfo { hasNextPage endCursor } nodes { datafordelerOpdateringstid datafordelerRegisterImportSequenceNumber datafordelerRowId datafordelerRowVersion ejerlavLokalId feltliste forretningshaendelse forretningsomraade forretningsproces id_lokalId id_namespace jordstykkeLokalId journaliseringsdato kommune matrikelmyndighedensJournalnum objectid registreringFra registreringsaktoer registreringTil rekvirentRef sagstitel status StedbestemmelsesGeometri virkningFra virkningsaktoer virkningTil ejerlighedTilhoererMatrikulaerSag(first: 10) { nodes { id_lokalId status senesteSagLokalId } } objectid_336_MatrikulaerSag_sagsoperation_matrikulaersagobjectid_ref { nodes { betegnelse } } } } }",
  "variables": {
    "registreringstid": "2025-01-23T10:39:04.658307Z",
    "virkningstid": "2025-01-23T10:39:04.658307Z",
    "id_lokalId": "7590064"
  }
}
```

### Response
#### Success Response (200)
- **pageInfo** (Object) - Information about pagination.
  - **hasNextPage** (Boolean) - Indicates if there are more pages.
  - **endCursor** (String) - The cursor for the last item on the current page.
- **nodes** (Array) - An array of MatrikulaerSag objects.
  - **datafordelerOpdateringstid** (String)
  - **datafordelerRegisterImportSequenceNumber** (Int)
  - **datafordelerRowId** (String)
  - **datafordelerRowVersion** (String)
  - **ejerlavLokalId** (String)
  - **feltliste** (String)
  - **forretningshaendelse** (String)
  - **forretningsomraade** (String)
  - **forretningsproces** (String)
  - **id_lokalId** (String)
  - **id_namespace** (String)
  - **jordstykkeLokalId** (String)
  - **journaliseringsdato** (String)
  - **kommune** (String)
  - **matrikelmyndighedensJournalnum** (String)
  - **objectid** (String)
  - **registreringFra** (String)
  - **registreringsaktoer** (String)
  - **registreringTil** (String)
  - **rekvirentRef** (String)
  - **sagstitel** (String)
  - **status** (String)
  - **StedbestemmelsesGeometri** (String)
  - **virkningFra** (String)
  - **virkningsaktoer** (String)
  - **virkningTil** (String)
  - **ejerlighedTilhoererMatrikulaerSag** (Object) - Related Ejerlejlighed entities.
    - **nodes** (Array) - Array of related nodes.
      - **id_lokalId** (String)
      - **status** (String)
      - **senesteSagLokalId** (String)
  - **objectid_336_MatrikulaerSag_sagsoperation_matrikulaersagobjectid_ref** (Object) - Reference to sagsoperation.
    - **nodes** (Array) - Array of related nodes.
      - **betegnelse** (String)

#### Response Example
```json
{
  "data": {
    "MAT_MatrikulaerSag": {
      "pageInfo": {
        "hasNextPage": false,
        "endCursor": null
      },
      "nodes": [
        {
          "datafordelerOpdateringstid": "2023-10-27T10:00:00Z",
          "datafordelerRegisterImportSequenceNumber": 12345,
          "datafordelerRowId": "some-row-id",
          "datafordelerRowVersion": "some-row-version",
          "ejerlavLokalId": "123",
          "feltliste": "some-list",
          "forretningshaendelse": "some-haendelse",
          "forretningsomraade": "some-omraade",
          "forretningsproces": "some-proces",
          "id_lokalId": "7590064",
          "id_namespace": "some-namespace",
          "jordstykkeLokalId": "456",
          "journaliseringsdato": "2023-10-26T09:00:00Z",
          "kommune": "101",
          "matrikelmyndighedensJournalnum": "MJ-789",
          "objectid": "obj-101",
          "registreringFra": "2023-10-25T08:00:00Z",
          "registreringsaktoer": "RegAktoer",
          "registreringTil": null,
          "rekvirentRef": "Ref-123",
          "sagstitel": "Sample Case",
          "status": "Active",
          "StedbestemmelsesGeometri": "POINT(10 20)",
          "virkningFra": "2023-10-25T08:00:00Z",
          "virkningsaktoer": "VirkAktoer",
          "virkningTil": null,
          "ejerlighedTilhoererMatrikulaerSag": {
            "nodes": [
              {
                "id_lokalId": "EJL-1",
                "status": "Active",
                "senesteSagLokalId": "7590064"
              }
            ]
          },
          "objectid_336_MatrikulaerSag_sagsoperation_matrikulaersagobjectid_ref": {
            "nodes": [
              {
                "betegnelse": "Operation C"
              }
            ]
          }
        }
      ]
    }
  }
}
```
```

--------------------------------

### MAT_MatrikulaerSag - BygningPaaFremmedGrundPunkt

Source: https://confluence.sdfi.dk/display/DML/Udvalgte+REST-tjenester+omsat+til+GraphQL-queries/index

This query retrieves MatrikulaerSag data starting from the BygningPaaFremmedGrundPunkt entity. It requires 'registreringstid' and 'virkningstid' as input parameters and filters by 'id_lokalId'.

```APIDOC
## MAT_MatrikulaerSag - BygningPaaFremmedGrundPunkt

### Description
Retrieves MatrikulaerSag data with a focus on related BygningPaaFremmedGrundPunkt entities. Requires registration and effect times, and filters by a local ID.

### Method
POST

### Endpoint
/graphql

### Parameters
#### Query Parameters
- **registreringstid** (String) - Required - The registration time for the query.
- **virkningstid** (String) - Required - The effect time for the query.

#### Request Body
- **query** (String) - Required - The GraphQL query string.
- **variables** (Object) - Optional - Variables for the query.
  - **where.id_lokalId.eq** (String) - Required - The local ID to filter by.

### Request Example
```json
{
  "query": "query ($registreringstid: String!, $virkningstid: String!, $id_lokalId: String!) { MAT_MatrikulaerSag(first: 1, registreringstid: $registreringstid, virkningstid: $virkningstid, where: { id_lokalId: { eq: $id_lokalId } }) { pageInfo { hasNextPage endCursor } nodes { datafordelerOpdateringstid datafordelerRegisterImportSequenceNumber datafordelerRowId datafordelerRowVersion ejerlavLokalId feltliste forretningshaendelse forretningsomraade forretningsproces id_lokalId id_namespace jordstykkeLokalId journaliseringsdato kommune matrikelmyndighedensJournalnum objectid registreringFra registreringsaktoer registreringTil rekvirentRef sagstitel status StedbestemmelsesGeometri virkningFra virkningsaktoer virkningTil bygningPaaFremmedGrundPunktTilhoererMatrikulaerSag(first: 10) { nodes { id_lokalId status senesteSagLokalId } } objectid_336_MatrikulaerSag_sagsoperation_matrikulaersagobjectid_ref { nodes { betegnelse } } } } }",
  "variables": {
    "registreringstid": "2025-01-23T10:39:04.658307Z",
    "virkningstid": "2025-01-23T10:39:04.658307Z",
    "id_lokalId": "7590064"
  }
}
```

### Response
#### Success Response (200)
- **pageInfo** (Object) - Information about pagination.
  - **hasNextPage** (Boolean) - Indicates if there are more pages.
  - **endCursor** (String) - The cursor for the last item on the current page.
- **nodes** (Array) - An array of MatrikulaerSag objects.
  - **datafordelerOpdateringstid** (String)
  - **datafordelerRegisterImportSequenceNumber** (Int)
  - **datafordelerRowId** (String)
  - **datafordelerRowVersion** (String)
  - **ejerlavLokalId** (String)
  - **feltliste** (String)
  - **forretningshaendelse** (String)
  - **forretningsomraade** (String)
  - **forretningsproces** (String)
  - **id_lokalId** (String)
  - **id_namespace** (String)
  - **jordstykkeLokalId** (String)
  - **journaliseringsdato** (String)
  - **kommune** (String)
  - **matrikelmyndighedensJournalnum** (String)
  - **objectid** (String)
  - **registreringFra** (String)
  - **registreringsaktoer** (String)
  - **registreringTil** (String)
  - **rekvirentRef** (String)
  - **sagstitel** (String)
  - **status** (String)
  - **StedbestemmelsesGeometri** (String)
  - **virkningFra** (String)
  - **virkningsaktoer** (String)
  - **virkningTil** (String)
  - **bygningPaaFremmedGrundPunktTilhoererMatrikulaerSag** (Object) - Related BygningPaaFremmedGrundPunkt entities.
    - **nodes** (Array) - Array of related nodes.
      - **id_lokalId** (String)
      - **status** (String)
      - **senesteSagLokalId** (String)
  - **objectid_336_MatrikulaerSag_sagsoperation_matrikulaersagobjectid_ref** (Object) - Reference to sagsoperation.
    - **nodes** (Array) - Array of related nodes.
      - **betegnelse** (String)

#### Response Example
```json
{
  "data": {
    "MAT_MatrikulaerSag": {
      "pageInfo": {
        "hasNextPage": false,
        "endCursor": null
      },
      "nodes": [
        {
          "datafordelerOpdateringstid": "2023-10-27T10:00:00Z",
          "datafordelerRegisterImportSequenceNumber": 12345,
          "datafordelerRowId": "some-row-id",
          "datafordelerRowVersion": "some-row-version",
          "ejerlavLokalId": "123",
          "feltliste": "some-list",
          "forretningshaendelse": "some-haendelse",
          "forretningsomraade": "some-omraade",
          "forretningsproces": "some-proces",
          "id_lokalId": "7590064",
          "id_namespace": "some-namespace",
          "jordstykkeLokalId": "456",
          "journaliseringsdato": "2023-10-26T09:00:00Z",
          "kommune": "101",
          "matrikelmyndighedensJournalnum": "MJ-789",
          "objectid": "obj-101",
          "registreringFra": "2023-10-25T08:00:00Z",
          "registreringsaktoer": "RegAktoer",
          "registreringTil": null,
          "rekvirentRef": "Ref-123",
          "sagstitel": "Sample Case",
          "status": "Active",
          "StedbestemmelsesGeometri": "POINT(10 20)",
          "virkningFra": "2023-10-25T08:00:00Z",
          "virkningsaktoer": "VirkAktoer",
          "virkningTil": null,
          "bygningPaaFremmedGrundPunktTilhoererMatrikulaerSag": {
            "nodes": [
              {
                "id_lokalId": "BPFG-P-1",
                "status": "Active",
                "senesteSagLokalId": "7590064"
              }
            ]
          },
          "objectid_336_MatrikulaerSag_sagsoperation_matrikulaersagobjectid_ref": {
            "nodes": [
              {
                "betegnelse": "Operation B"
              }
            ]
          }
        }
      ]
    }
  }
}
```
```

--------------------------------

### Fetch Building Data with Pagination and Relationships (GraphQL)

Source: https://confluence.sdfi.dk/display/DML/Udvalgte+REST-tjenester+omsat+til+GraphQL-queries/display/DML/Udvalgte%2BREST-tjenester%2Bomsat%2Btil%2BGraphQL-queries

This GraphQL query retrieves detailed information about buildings, including their relationships to properties on foreign land. It utilizes pagination to fetch data in chunks and includes various attributes of the building and its related entities.

```graphql
{
  bygning {
    pageInfo {
      hasNextPage
      endCursor
    }
    nodes {
      bygning
      bygningPaaFremmedGrund
      datafordelerOpdateringstid
      datafordelerRegisterImportSequenceNumber
      datafordelerRowId
      datafordelerRowVersion
      forretningshaendelse
      forretningsomraade
      forretningsproces
      id_lokalId
      id_namespace
      kommunekode
      registreringFra
      registreringsaktoer
      registreringTil
      status
      virkningFra
      virkningsaktoer
      virkningTil
      ejendomsrelationBygningPaaFremmedGrund {
        bfeNummer
        bygningPaaFremmedGrund
        datafordelerOpdateringstid
        datafordelerRegisterImportSequenceNumber
        datafordelerRowId
        datafordelerRowVersion
        ejendommensEjerforholdskode
        ejendomsnummer
        ejendomstype
        ejerlejlighed
        ejerlejlighedsnummer
        forretningshaendelse
        forretningsomraade
        forretningsproces
        id_lokalId
        id_namespace
        kommunekode
        registreringFra
        registreringsaktoer
        registreringTil
        samletFastEjendom
        status
        tinglystAreal
        virkningFra
        virkningsaktoer
        virkningTil
        vurderingsejendomsnummer
      }
    }
  }
}
```

--------------------------------

### Query for Apartment Details (GraphQL)

Source: https://confluence.sdfi.dk/display/DML/Udvalgte+REST-tjenester+omsat+til+GraphQL-queries/index

This GraphQL query fetches detailed information about apartments. It includes fields like the business event, origin, and registration details. The query also allows for nested queries to retrieve further information about the building the apartment is part of.

```graphql
query LejlighedsDetaljer($first: Int, $after: String) {
  ejerlejlighedErDelAfBygningPaaFremmedGrundFlade(first: $first, after: $after) {
    pageInfo {
      hasNextPage
      endCursor
    }
    nodes {
      BFEnummer
      datafordelerOpdateringstid
      datafordelerRegisterImportSequenceNumber
      datafordelerRowId
      datafordelerRowVersion
      feltliste
      forretningshaendelse
      forretningsomraade
      forretningsproces
      id_lokalId
      id_namespace
      objectid
      opdeltIEjerlejligheder
      oprindelse
      paaHavet
      paataenktHandling
      registreringFra
      registreringsaktoer
      registreringTil
      rids
      samletFastEjendomLokalId
      senesteSagLokalId
      status
      StedbestemmelsesReference
      virkningFra
      virkningsaktoer
      virkningTil
      ejerlejlighedErDelAfBygningPaaFremmedGrundFlade(first: 10) {
        pageInfo {
          hasNextPage
          endCursor
        }
        nodes {
          b_BygningPaaFremmedGrundFladeL
          b_BygningPaaFremmedGrundPunktL
          BFEnummer
          datafordelerOpdateringstid
          datafordelerRegisterImportSequenceNumber
          datafordelerRowId
          datafordelerRowVersion
          ejerlejlighedskort
          ejerlejlighedsnummer
          feltliste
          fordelingstalNaevner
          fordelingstalTaeller
          forretningshaendelse
          forretningsomraade
          forretningsproces
          iBygningPaaFremmedGrund
          id_lokalId
          id_namespace
          objectid
          paataenktHandling
          registreringFra
          registreringsaktoer
          registreringTil
          samletAreal
          samletFastEjendomLokalId
          senesteSagLokalId
          status
          StedbestemmelsesGeometri
          StedbestemmelsesReference
          virkningFra
          virkningsaktoer
          virkningTil
        }
      }
    }
  }
}
```

--------------------------------

### MAT_MatrikulaerSag - BygningPaaFremmedGrundFlade

Source: https://confluence.sdfi.dk/display/DML/Udvalgte+REST-tjenester+omsat+til+GraphQL-queries/index

This query retrieves MatrikulaerSag data starting from the BygningPaaFremmedGrundFlade entity. It requires 'registreringstid' and 'virkningstid' as input parameters and filters by 'id_lokalId'.

```APIDOC
## MAT_MatrikulaerSag - BygningPaaFremmedGrundFlade

### Description
Retrieves MatrikulaerSag data with a focus on related BygningPaaFremmedGrundFlade entities. Requires registration and effect times, and filters by a local ID.

### Method
POST

### Endpoint
/graphql

### Parameters
#### Query Parameters
- **registreringstid** (String) - Required - The registration time for the query.
- **virkningstid** (String) - Required - The effect time for the query.

#### Request Body
- **query** (String) - Required - The GraphQL query string.
- **variables** (Object) - Optional - Variables for the query.
  - **where.id_lokalId.eq** (String) - Required - The local ID to filter by.

### Request Example
```json
{
  "query": "query ($registreringstid: String!, $virkningstid: String!, $id_lokalId: String!) { MAT_MatrikulaerSag(first: 1, registreringstid: $registreringstid, virkningstid: $virkningstid, where: { id_lokalId: { eq: $id_lokalId } }) { pageInfo { hasNextPage endCursor } nodes { datafordelerOpdateringstid datafordelerRegisterImportSequenceNumber datafordelerRowId datafordelerRowVersion ejerlavLokalId feltliste forretningshaendelse forretningsomraade forretningsproces id_lokalId id_namespace jordstykkeLokalId journaliseringsdato kommune matrikelmyndighedensJournalnum objectid registreringFra registreringsaktoer registreringTil rekvirentRef sagstitel status StedbestemmelsesGeometri virkningFra virkningsaktoer virkningTil bygningPaaFremmedGrundFladeTilhoererMatrikulaerSag(first: 10) { nodes { id_lokalId status senesteSagLokalId } } objectid_336_MatrikulaerSag_sagsoperation_matrikulaersagobjectid_ref { nodes { betegnelse } } } } }",
  "variables": {
    "registreringstid": "2025-01-23T10:39:04.658307Z",
    "virkningstid": "2025-01-23T10:39:04.658307Z",
    "id_lokalId": "7590064"
  }
}
```

### Response
#### Success Response (200)
- **pageInfo** (Object) - Information about pagination.
  - **hasNextPage** (Boolean) - Indicates if there are more pages.
  - **endCursor** (String) - The cursor for the last item on the current page.
- **nodes** (Array) - An array of MatrikulaerSag objects.
  - **datafordelerOpdateringstid** (String)
  - **datafordelerRegisterImportSequenceNumber** (Int)
  - **datafordelerRowId** (String)
  - **datafordelerRowVersion** (String)
  - **ejerlavLokalId** (String)
  - **feltliste** (String)
  - **forretningshaendelse** (String)
  - **forretningsomraade** (String)
  - **forretningsproces** (String)
  - **id_lokalId** (String)
  - **id_namespace** (String)
  - **jordstykkeLokalId** (String)
  - **journaliseringsdato** (String)
  - **kommune** (String)
  - **matrikelmyndighedensJournalnum** (String)
  - **objectid** (String)
  - **registreringFra** (String)
  - **registreringsaktoer** (String)
  - **registreringTil** (String)
  - **rekvirentRef** (String)
  - **sagstitel** (String)
  - **status** (String)
  - **StedbestemmelsesGeometri** (String)
  - **virkningFra** (String)
  - **virkningsaktoer** (String)
  - **virkningTil** (String)
  - **bygningPaaFremmedGrundFladeTilhoererMatrikulaerSag** (Object) - Related BygningPaaFremmedGrundFlade entities.
    - **nodes** (Array) - Array of related nodes.
      - **id_lokalId** (String)
      - **status** (String)
      - **senesteSagLokalId** (String)
  - **objectid_336_MatrikulaerSag_sagsoperation_matrikulaersagobjectid_ref** (Object) - Reference to sagsoperation.
    - **nodes** (Array) - Array of related nodes.
      - **betegnelse** (String)

#### Response Example
```json
{
  "data": {
    "MAT_MatrikulaerSag": {
      "pageInfo": {
        "hasNextPage": false,
        "endCursor": null
      },
      "nodes": [
        {
          "datafordelerOpdateringstid": "2023-10-27T10:00:00Z",
          "datafordelerRegisterImportSequenceNumber": 12345,
          "datafordelerRowId": "some-row-id",
          "datafordelerRowVersion": "some-row-version",
          "ejerlavLokalId": "123",
          "feltliste": "some-list",
          "forretningshaendelse": "some-haendelse",
          "forretningsomraade": "some-omraade",
          "forretningsproces": "some-proces",
          "id_lokalId": "7590064",
          "id_namespace": "some-namespace",
          "jordstykkeLokalId": "456",
          "journaliseringsdato": "2023-10-26T09:00:00Z",
          "kommune": "101",
          "matrikelmyndighedensJournalnum": "MJ-789",
          "objectid": "obj-101",
          "registreringFra": "2023-10-25T08:00:00Z",
          "registreringsaktoer": "RegAktoer",
          "registreringTil": null,
          "rekvirentRef": "Ref-123",
          "sagstitel": "Sample Case",
          "status": "Active",
          "StedbestemmelsesGeometri": "POINT(10 20)",
          "virkningFra": "2023-10-25T08:00:00Z",
          "virkningsaktoer": "VirkAktoer",
          "virkningTil": null,
          "bygningPaaFremmedGrundFladeTilhoererMatrikulaerSag": {
            "nodes": [
              {
                "id_lokalId": "BPFG-1",
                "status": "Active",
                "senesteSagLokalId": "7590064"
              }
            ]
          },
          "objectid_336_MatrikulaerSag_sagsoperation_matrikulaersagobjectid_ref": {
            "nodes": [
              {
                "betegnelse": "Operation A"
              }
            ]
          }
        }
      ]
    }
  }
}
```
```

--------------------------------

### Query Building Information with Pagination (GraphQL)

Source: https://confluence.sdfi.dk/display/DML/Udvalgte+REST-tjenester+omsat+til+GraphQL-queries/display/DML/Udvalgte%2BREST-tjenester%2Bomsat%2Btil%2BGraphQL-queries_src=contextnavpagetreemode

This GraphQL query retrieves information about buildings and their associated apartment details. It utilizes pagination to fetch data in chunks, indicated by 'first: 10' and the 'pageInfo' object for cursor-based navigation.

```graphql
{
  ejerlejlighedErDelAfBygningPaaFremmedGrundFlade(first: 10) {
    pageInfo {
      hasNextPage
      endCursor
    }
    nodes {
      BFEnummer
      datafordelerOpdateringstid
      datafordelerRegisterImportSequenceNumber
      datafordelerRowId
      datafordelerRowVersion
      feltliste
      forretningshaendelse
      forretningsomraade
      forretningsproces
      id_lokalId
      id_namespace
      objectid
      opdeltIEjerlejligheder
      oprindelse
      paaHavet
      paataenktHandling
      registreringFra
      registreringsaktoer
      registreringTil
      rids
      samletFastEjendomLokalId
      senesteSagLokalId
      status
      StedbestemmelsesReference
      virkningFra
      virkningsaktoer
      virkningTil
      ejerlejlighedErDelAfBygningPaaFremmedGrundFlade(first: 10) {
        pageInfo {
          hasNextPage
          endCursor
        }
        nodes {
          b_BygningPaaFremmedGrundFladeL
          b_BygningPaaFremmedGrundPunktL
          BFEnummer
          datafordelerOpdateringstid
          datafordelerRegisterImportSequenceNumber
          datafordelerRowId
          datafordelerRowVersion
          ejerlejlighedskort
          ejerlejlighedsnummer
          feltliste
          fordelingstalNaevner
          fordelingstalTaeller
          forretningshaendelse
          forretningsomraade
          forretningsproces
          iBygningPaaFremmedGrund
          id_lokalId
          id_namespace
          objectid
          paataenktHandling
          registreringFra
          registreringsaktoer
          registreringTil
          samletAreal
          samletFastEjendomLokalId
          senesteSagLokalId
          status
          StedbestemmelsesGeometri
          StedbestemmelsesReference
          virkningFra
          virkningsaktoer
          virkningTil
        }
      }
    }
  }
}
```