Mastedatabasen.dk API documentation

Introduction

The Mastedatabasen.dk API is a RESTful API that allows you to access the data in the Mastedatabasen.dk dataset with more convenient filtering and syntax.

The API conforms to the JSON:API specification in its responses, providing JSON responses at all documented endpoints, with corresponding data being located within the data key, included resources for relationships within the included key, and relevant links (such as next/previous pages of results) under the links key.

For more info about JSON:API, and how responses are formatted, please see the JSON:API specification. The site also contains links to various packages which can handle the fetching and parsing of data from JSON:API-compliant services, like this.

Endpoints

/frequency-bands

Description

Lists all frequency bands in the Mastedatabasen.dk dataset.

Parameters

None.

Example response

Show response
{
  "data": [
    {
      "id": "1",
      "type": "frequency-bands",
      "attributes": {
        "frequencyBand": 700,
        "sitesCount": 5723
      }
    },
    {
      "id": "2",
      "type": "frequency-bands",
      "attributes": {
        "frequencyBand": 800,
        "sitesCount": 6331
      }
    },
    {
      "id": "3",
      "type": "frequency-bands",
      "attributes": {
        "frequencyBand": 900,
        "sitesCount": 14743
      }
    },
    {
      "id": "4",
      "type": "frequency-bands",
      "attributes": {
        "frequencyBand": 1800,
        "sitesCount": 9525
      }
    },
    {
      "id": "5",
      "type": "frequency-bands",
      "attributes": {
        "frequencyBand": 2100,
        "sitesCount": 8422
      }
    },
    {
      "id": "6",
      "type": "frequency-bands",
      "attributes": {
        "frequencyBand": 2300,
        "sitesCount": 188
      }
    },
    {
      "id": "7",
      "type": "frequency-bands",
      "attributes": {
        "frequencyBand": 2600,
        "sitesCount": 3113
      }
    },
    {
      "id": "8",
      "type": "frequency-bands",
      "attributes": {
        "frequencyBand": 3500,
        "sitesCount": 1565
      }
    },
    {
      "id": "9",
      "type": "frequency-bands",
      "attributes": {
        "frequencyBand": 26000,
        "sitesCount": 3
      }
    }
  ]
}

/operators

Description

Lists all operators in the Mastedatabasen.dk dataset.

Parameters

None.

Example response

Show response
{
  "data": [
    {
      "id": "1",
      "type": "operators",
      "attributes": {
        "operatorName": "Banedanmark",
        "sitesCount": 318
      }
    },
    {
      "id": "2",
      "type": "operators",
      "attributes": {
        "operatorName": "TDC Mobil A/S",
        "sitesCount": 18984
      }
    },
    {
      "id": "3",
      "type": "operators",
      "attributes": {
        "operatorName": "Cibicom",
        "sitesCount": 36
      }
    },
    {
      "id": "4",
      "type": "operators",
      "attributes": {
        "operatorName": "Telia - Telenor (TT Netværket)",
        "sitesCount": 18529
      }
    },
    {
      "id": "5",
      "type": "operators",
      "attributes": {
        "operatorName": "Hi3G Denmark ApS",
        "sitesCount": 12100
      }
    },
    {
      "id": "6",
      "type": "operators",
      "attributes": {
        "operatorName": "Norlys",
        "sitesCount": 45
      }
    },
    {
      "id": "7",
      "type": "operators",
      "attributes": {
        "operatorName": "Danmarks Radio",
        "sitesCount": 128
      }
    }
  ]
}

/service-types

Description

Lists all service types in the Mastedatabasen.dk dataset.

Parameters

None.

Example response

Show response
{
  "data": [
    {
      "id": "1",
      "type": "service-types",
      "attributes": {
        "serviceName": "Other",
        "sitesCount": 496
      }
    },
    {
      "id": "2",
      "type": "service-types",
      "attributes": {
        "serviceName": "Mobile telecoms",
        "sitesCount": 49613
      }
    },
    {
      "id": "3",
      "type": "service-types",
      "attributes": {
        "serviceName": "Technology-neutral",
        "sitesCount": 31
      }
    }
  ]
}

/technologies

Description

Lists all technologies in the Mastedatabasen.dk dataset.

Parameters

None.

Example response

Show response
{
  "data": [
    {
      "id": "1",
      "type": "technologies",
      "attributes": {
        "technologyName": "DAB",
        "sitesCount": 64
      }
    },
    {
      "id": "2",
      "type": "technologies",
      "attributes": {
        "technologyName": "DVB-T",
        "sitesCount": 90
      }
    },
    {
      "id": "3",
      "type": "technologies",
      "attributes": {
        "technologyName": "FM",
        "sitesCount": 23
      }
    },
    {
      "id": "4",
      "type": "technologies",
      "attributes": {
        "technologyName": "Fixed wireless access",
        "sitesCount": 0
      }
    },
    {
      "id": "5",
      "type": "technologies",
      "attributes": {
        "technologyName": "GSM-R",
        "sitesCount": 318
      }
    },
    {
      "id": "6",
      "type": "technologies",
      "attributes": {
        "technologyName": "Land-based mobile radio",
        "sitesCount": 0
      }
    },
    {
      "id": "7",
      "type": "technologies",
      "attributes": {
        "technologyName": "Radio chain",
        "sitesCount": 0
      }
    },
    {
      "id": "8",
      "type": "technologies",
      "attributes": {
        "technologyName": "TV",
        "sitesCount": 0
      }
    },
    {
      "id": "9",
      "type": "technologies",
      "attributes": {
        "technologyName": "NR",
        "sitesCount": 5979
      }
    },
    {
      "id": "10",
      "type": "technologies",
      "attributes": {
        "technologyName": "LTE",
        "sitesCount": 27776
      }
    },
    {
      "id": "11",
      "type": "technologies",
      "attributes": {
        "technologyName": "UMTS",
        "sitesCount": 10211
      }
    },
    {
      "id": "12",
      "type": "technologies",
      "attributes": {
        "technologyName": "GSM",
        "sitesCount": 5647
      }
    },
    {
      "id": "13",
      "type": "technologies",
      "attributes": {
        "technologyName": "TK",
        "sitesCount": 0
      }
    },
    {
      "id": "14",
      "type": "technologies",
      "attributes": {
        "technologyName": "Technology-neutral",
        "sitesCount": 31
      }
    },
    {
      "id": "15",
      "type": "technologies",
      "attributes": {
        "technologyName": "Other",
        "sitesCount": 1
      }
    }
  ]
}

/sites

Description

Lists all sites in the Mastedatabasen.dk dataset.

Includes each site's frequency band, operator, service type and technology (if available) by default as relationships. The data for these models will be present in the included portion of the body.

Parameters

Query parameter Description Example value Default
filter[bounding_box] The latitude and longitude (WGS:84) bounding box to search within. (lat1,lon1,lat2,lon2) 56.25,12.5,56.5,12.75 None
filter[frequency_band] The frequency band ID to filter by. 1 None
filter[operator] The operator ID to filter by. 2 None
filter[service_type] The service type ID to filter by. 1 None
filter[technology] The technology ID to filter by. 9 None
page[limit] The maximum number of results to return. (Maximum: 5000) 25 5000
page[offset] The maximum number of results to skip. Use this to access pages of results. 200 0

Example URL requests

Filter by latitude and longitude

/sites?filter[bounding_box]=56.25,12.5,56.5,12.75

Lists the first 5000 sites between LatLng(56.25, 12.5) and LatLng(56.5, 12.75).

Filter by lat, lon, operator and technology

/sites?filter[bounding_box]=56.25,12.5,56.5,12.75&filter[operator]=2&filter[technology]=9

Lists the first 5000 sites between LatLng(56.25, 12.5) and LatLng(56.5, 12.75), operated by TDC Mobil A/S (operator ID #2), utilising 5G NR (technology ID #9).

Filter by technology with page size of 20

/sites?filter[technology]=5&page[limit]=20

Lists the first 20 sites utilizing GSM-R (technology ID #5).

Example response

Show response