Official Redlist Api API Reference

This is the official API for accessing the Danish Redlist and its content. The API provides access to all publicly available data for the redlist. In the documentation found on this site, details on every field is described. The API is a REST API and provides data in a JSON format.
Version 1.2 update: Vurderingsrunde now accepts the alias 'latest'. Please use this to ensure you get the latest data. Other values for vurderingsrunde might give you previous versions of assessments.

API Endpoint
https://api.redlist.au.dk/public/v1
Terms of Service: https://api.redlist.au.dk/docs/terms.html
Contact: redlistapi@bios.au.dk
Schemes: https
Version: 1.2.0

Assessments

Assessment methods provide access to information and operations relating to assessments of species

Assessments

List assessments

GET /assessments

Retrieve a list of assessments. The result is paginated and takes the optional query parameter 'page' (starting at page 1). The result includes the page retrieved and the total number of pages.

Note that adding multiple query parameters require ALL conditions to be fulfilled (i.e. 'speciesName=A*&speciesFamily=Carabidae') will return all species starting with A from the family Carabidae.

page: integer
in query

The page to retrieve (starts at page 1)

taxoxId: integer
in query

A specific taxonId. This will at most return 1 assessment.

speciesName: string
in query

A species name to look for. Either a full name (ie. Cymindis macularis or a partial name such as Cym* or *macularis)

speciesFamily: string
in query

A species family to look for. Either a full name (ie. Carabidae or a partial name such as Car* or *abidae)

speciesOrder: string
in query

A species order to look for. Either a full name (ie. Coleoptera or a partial name such as Col* or *tera)

speciesGroup: string
in query

A species group to look for. Either a full name (ie. Bier or a partial name such as B* or *ier)

threat: string
in query

Find all assessments that has this threat in its list of threats. Name of the threat, i.e. Andet. Must be the full name of the threat.

specificThreat: integer
in query

Find all assessments that has this specific threat in its list of threats. Id of the specific threat, i.e. 66

habitat: string
in query

Comma separated list of habitatIds. Returns all species with at least one of the specified habitats. I.e. 1,4,7

diets: string
in query

Comma separated list of dietIds. Returns all species with at least one of the specified diets. I.e. 1,4,7

redlistCategory: string
in query

Comma separated list of redlist categories. Returns all assessments with a category in the given list. I.e. CR,EN,VU,NT.

sortColumn: string
in query

The property to sort the returned result set by. Defaults to 'scientificName'. Supported values are: vernacularName, family, order, speciesGroup, redlistCategory.

direction: string
in query

ASC for ascending sort order, DESC for descending. Defaults to ASC.

vurderingsRunde: string
in query

The vurderings-runde to query. Use 'latest' to automatically get the latest assessments. If you specifically need older versions the accepted values are currently: 2010, 2019 and 2030

200 OK
AssessmentResult

Successful operation

Response Content-Types: application/json
Response Example (200 OK) 
{
  "page": 1,
  "pages": 1,
  "total": 1,
  "data": [
    {
      "id": 1,
      "assessmentDate": 2018,
      "speciesInformation": {
        "taxonID": 10339,
        "scientificName": "Cymindis macularis",
        "family": "Carabidae",
        "order": "Coleoptera",
        "scientificNameAuthorship": "Mannerheim, 1823",
        "vernacularName": "Bredbrystet hedeløber",
        "population": "National",
        "arterDkId": "d31dcb5c-4d90-4166-b046-acf400b896bb"
      },
      "redlistCategory": {
        "category": "VU",
        "criteria": "B2a",
        "upDownListing": "*"
      },
      "documentation": {
        "documentationScreening": "Some documentation text or null",
        "documentationPopReduction": "Some documentation text or null",
        "documentationGeographicExtent": "Some documentation text or null",
        "documentationPopSize": "Some documentation text or null",
        "documentationQuantitativeAnalysis": "Some documentation text or null"
      },
      "habitat": {
        "ecosystems": [
          "Terrestrisk"
        ],
        "overallHabitatTypes": [
          "Skove",
          "Græsland"
        ],
        "specificHabitatTypes": [
          "Sandet skov",
          "Tør hede",
          "Tørgræsland",
          "Sandgræsland"
        ],
        "substrates": [
          "Sand"
        ],
        "diets": [
          "Veterantræer",
          "Plankton"
        ],
        "dietsSpecies": [
          {
            "taxonID": 2,
            "scientificName": "Abdera bifasciata",
            "scientificNameAuthorship": "Marsham, 1802"
          },
          {
            "taxonID": 3,
            "scientificName": "Abdera flexuosa",
            "scientificNameAuthorship": "(Paykull, 1799)"
          }
        ],
        "dietsGenera": [
          "Heteropterus",
          "Heterorhabditis"
        ],
        "humidity": {
          "min": 1,
          "max": 12
        },
        "reaction": {
          "min": 1,
          "max": 9
        },
        "nutrient": {
          "min": 1,
          "max": 9
        },
        "salinity": {
          "min": 1,
          "max": 9
        },
        "lightCondition": {
          "min": 1,
          "max": 9
        },
        "temperature": {
          "min": 1,
          "max": 9
        },
        "disturbance": {
          "min": "Moderate/regular",
          "max": "Intense/often"
        }
      },
      "additionalInformation": {
        "yearOfFirstRecord": 1900,
        "yearOfMostRecentRecord": 1982,
        "trend": "Increasing"
      }
    }
  ]
}
Assessments

List assessments extended

GET /extended/assessments/

See /assessments

page: integer
in query

The page to retrieve (starts at page 1)

taxoxId: integer
in query

A specific taxonId. This will at most return 1 assessment.

speciesName: string
in query

A species name to look for. Either a full name (ie. Cymindis macularis or a partial name such as Cym* or *macularis)

speciesFamily: string
in query

A species family to look for. Either a full name (ie. Carabidae or a partial name such as Car* or *abidae)

speciesOrder: string
in query

A species order to look for. Either a full name (ie. Coleoptera or a partial name such as Col* or *tera)

speciesGroup: string
in query

A species group to look for. Either a full name (ie. Bier or a partial name such as B* or *ier)

threat: string
in query

Find all assessments that has this threat in its list of threats. Name of the threat, i.e. Andet. Must be the full name of the threat.

specificThreat: integer
in query

Find all assessments that has this specific threat in its list of threats. Id of the specific threat, i.e. 66

habitat: string
in query

Comma separated list of habitatIds. Returns all species with at least one of the specified habitats. I.e. 1,4,7

diets: string
in query

Comma separated list of dietIds. Returns all species with at least one of the specified diets. I.e. 1,4,7

redlistCategory: string
in query

Comma separated list of redlist categories. Returns all assessments with a category in the given list. I.e. CR,EN,VU,NT.

sortColumn: string
in query

The property to sort the returned result set by. Defaults to 'scientificName'. Supported values are: vernacularName, family, order, speciesGroup, redlistCategory.

direction: string
in query

ASC for ascending sort order, DESC for descending. Defaults to ASC.

vurderingsRunde: string
in query

The vurderings-runde to query. Use 'latest' to automatically get the latest assessments. If you specifically need older versions the accepted values are currently: 2010, 2019 and 2030

200 OK
AssessmentExtendedResult

Successful operation

Response Content-Types: application/json
Response Example (200 OK) 
{
  "page": "integer",
  "pages": "integer",
  "data": [
    {
      "extended": {
        "historicNumberOfLocalities": "integer",
        "historicTrendDescription": "string",
        "native": "bool",
        "geographicExtentCrossesRegion": "bool",
        "threatenedHabitats": "array",
        "threats": "array",
        "nationalDistribution": "string",
        "totalDistribution": "string",
        "commentsForNomenclature": "string",
        "geography": {
          "extentOfOccurrence": "string",
          "areaOfOccurrence": "string",
          "numberOfLocations": "string",
          "fragmented": "string"
        },
        "population": {
          "matureIndividuals": "string",
          "reduction": {
            "amount": "string",
            "timespan": "string"
          }
        },
        "references": "string",
        "commentsForAdditionalInformation": "string",
        "additionalComments": "string"
      },
      "id": "integer (int64)",
      "assessmentDate": "integer (int32)",
      "speciesInformation": {
        "taxonID": 10339,
        "scientificName": "Cymindis macularis",
        "family": "Carabidae",
        "order": "Coleoptera",
        "scientificNameAuthorship": "Mannerheim, 1823",
        "vernacularName": "Bredbrystet hedeløber",
        "arterDkId": "d31dcb5c-4d90-4166-b046-acf400b896bb"
      },
      "redlistCategory": {
        "category": "EN",
        "criteria": "B2ab",
        "upDownListing": "*"
      },
      "documentation": {
        "documentationScreening": "string",
        "documentationPopulationReduction": "string",
        "documentationGeographicExtent": "string",
        "documentationPopulationSize": "string",
        "documentationQuantitativeAnalysis": "string"
      },
      "habitat": {
        "overallHabitatTypes": [
          "string"
        ],
        "specificHabitatTypes": [
          "string"
        ],
        "substrates": [
          "string"
        ],
        "diets": [
          "string"
        ],
        "dietsSpecies": [
          {
            "taxonID": "integer (int64)",
            "scientificName": "string",
            "scientificNameAuthorship": "string"
          }
        ],
        "dietsGenera": [
          "string"
        ],
        "humidity": {
          "min": "integer",
          "max": "integer"
        },
        "reaction": {
          "min": "integer",
          "max": "integer"
        },
        "nutrient": {
          "min": "integer",
          "max": "integer"
        },
        "salinity": {
          "min": "integer",
          "max": "integer"
        },
        "lightCondition": {
          "min": "integer",
          "max": "integer"
        },
        "temperature": {
          "min": "integer",
          "max": "integer"
        },
        "disturbance": {
          "min": "string",
          "max": "string"
        }
      },
      "additionalInformation": {
        "yearOfFirstRecord": "integer",
        "yearOfMostRecentRecord": "integer",
        "trend": "string"
      }
    }
  ]
}
Assessments

List assessments summary.

GET /summary/assessments/

See /assessments

page: integer
in query

The page to retrieve (starts at page 1)

taxoxId: integer
in query

A specific taxonId. This will at most return 1 assessment.

speciesName: string
in query

A species name to look for. Either a full name (ie. Cymindis macularis or a partial name such as Cym* or *macularis)

vernacularName: string
in query

The vernacular danish name to look for. Either a full name (ie. Ulv or a partial name such as Lille* or *gråsisken)

speciesFamily: string
in query

A species family to look for. Either a full name (ie. Carabidae or a partial name such as Car* or *abidae)

speciesOrder: string
in query

A species order to look for. Either a full name (ie. Coleoptera or a partial name such as Col* or *tera)

speciesGroup: string
in query

A species group to look for. Either a full name (ie. Bier or a partial name such as B* or *ier)

threat: string
in query

Find all assessments that has this threat in its list of threats. Name of the threat, i.e. Andet. Must be the full name of the threat.

specificThreat: integer
in query

Find all assessments that has this specific threat in its list of threats. Id of the specific threat, i.e. 66

habitat: string
in query

Comma separated list of habitatIds. Returns all species with at least one of the specified habitats. I.e. 1,4,7

diets: string
in query

Comma separated list of dietIds. Returns all species with at least one of the specified diets. I.e. 1,4,7

redlistCategory: string
in query

Comma separated list of redlist categories. Returns all assessments with a category in the given list. I.e. CR,EN,VU,NT.

sortColumn: string
in query

The property to sort the returned result set by. Defaults to 'scientificName'. Supported values are: vernacularName, family, order, speciesGroup, redlistCategory.

direction: string
in query

ASC for ascending sort order, DESC for descending. Defaults to ASC.

vurderingsRunde: string
in query

The vurderings-runde to query. Use 'latest' to automatically get the latest assessments. If you specifically need older versions the accepted values are currently: 2010, 2019 and 2030

200 OK
AssessmentSummaryResult

Successful operation

Response Content-Types: application/json
Response Example (200 OK) 
{
  "page": 1,
  "pages": 1,
  "total": 2,
  "data": [
    {
      "taxonId": 37733,
      "scientificName": "Amanita regalis",
      "vernacularName": "Brun fluesvamp",
      "family": "Agaricaceae",
      "order": "Agaricales",
      "overallSpeciesGroup": "Svampe",
      "redlistCategory": "EN",
      "arterDkId": "d31dcb5c-4d90-4166-b046-acf400b896bb"
    },
    {
      "taxonId": 1431,
      "scientificName": "Amara crenata",
      "vernacularName": "Smal ovalløber",
      "redlistCategory": "CR",
      "family": "Carabidae",
      "order": "Coleoptera",
      "overallSpeciesGroup": "Biller",
      "arterDkId": "698211f4-f785-ea11-aa77-501ac539d1ea"
    }
  ]
}

Habitats

Habitats

List habitats.

GET /habitats

Get a list of all habitats. Can be filtered by query parameter by overall habitat and type.

type: string specificHabitat, overallHabitat
in query

The type of habitat to list. specificHabitat or overallHabitat.

overallHabitat: string
in query

Name of overall habitat to filter by.

200 OK

Successful operation

type
object
Response Content-Types: application/json
Response Example (200 OK) 
{
  "data": [
    {
      "id": 30005400067,
      "name": "Bygninger",
      "type": "specificHabitat",
      "overallHabitat": "Byer"
    }
  ]
}
Habitats

List all substrates.

GET /substrates

Get a list of all substrates. Can be filtered by query parameter by overall substrate and substrate type (substrate and diet).

type: string
in query

Either diet, substrate or overall.

overallSubstrate: string
in query

Name of overall substrate to filter by.

200 OK

Successful operation

type
object
Response Content-Types: application/json
Response Example (200 OK) 
[
  {
    "id": 20000540000,
    "name": "Bygninger",
    "type": "substrate",
    "overallSubstrate": "Sten/klipper"
  }
]

Schema Definitions

AssessmentResult: object

page: integer

The current page

pages: integer

The total number of pages

total: integer

The total number of assignments

data: AssessmentData

A list of assessments matching the filters provided in the query (or all assessments if no filters were provided).

AssessmentData
Example
{
  "page": 1,
  "pages": 1,
  "total": 1,
  "data": [
    {
      "id": 1,
      "assessmentDate": 2018,
      "speciesInformation": {
        "taxonID": 10339,
        "scientificName": "Cymindis macularis",
        "family": "Carabidae",
        "order": "Coleoptera",
        "scientificNameAuthorship": "Mannerheim, 1823",
        "vernacularName": "Bredbrystet hedeløber",
        "population": "National",
        "arterDkId": "d31dcb5c-4d90-4166-b046-acf400b896bb"
      },
      "redlistCategory": {
        "category": "VU",
        "criteria": "B2a",
        "upDownListing": "*"
      },
      "documentation": {
        "documentationScreening": "Some documentation text or null",
        "documentationPopReduction": "Some documentation text or null",
        "documentationGeographicExtent": "Some documentation text or null",
        "documentationPopSize": "Some documentation text or null",
        "documentationQuantitativeAnalysis": "Some documentation text or null"
      },
      "habitat": {
        "ecosystems": [
          "Terrestrisk"
        ],
        "overallHabitatTypes": [
          "Skove",
          "Græsland"
        ],
        "specificHabitatTypes": [
          "Sandet skov",
          "Tør hede",
          "Tørgræsland",
          "Sandgræsland"
        ],
        "substrates": [
          "Sand"
        ],
        "diets": [
          "Veterantræer",
          "Plankton"
        ],
        "dietsSpecies": [
          {
            "taxonID": 2,
            "scientificName": "Abdera bifasciata",
            "scientificNameAuthorship": "Marsham, 1802"
          },
          {
            "taxonID": 3,
            "scientificName": "Abdera flexuosa",
            "scientificNameAuthorship": "(Paykull, 1799)"
          }
        ],
        "dietsGenera": [
          "Heteropterus",
          "Heterorhabditis"
        ],
        "humidity": {
          "min": 1,
          "max": 12
        },
        "reaction": {
          "min": 1,
          "max": 9
        },
        "nutrient": {
          "min": 1,
          "max": 9
        },
        "salinity": {
          "min": 1,
          "max": 9
        },
        "lightCondition": {
          "min": 1,
          "max": 9
        },
        "temperature": {
          "min": 1,
          "max": 9
        },
        "disturbance": {
          "min": "Moderate/regular",
          "max": "Intense/often"
        }
      },
      "additionalInformation": {
        "yearOfFirstRecord": 1900,
        "yearOfMostRecentRecord": 1982,
        "trend": "Increasing"
      }
    }
  ]
}

AssessmentData: object

An assessment of a species with information about its habitat and redlist category.

id: integer (int64)

An ID uniquely identifying the assessment.

assessmentDate: integer (int32)

The year the assessment was made.

speciesInformation: SpeciesInformation

Basic information about the species.

redlistCategory: RedlistCategory

Information about the IUCN Redlist Category this assessment resulted in.

documentation: Documentation

Text description about different aspects of the assessment.

habitat: Habitat

Detailed description of the species habitat.

additionalInformation: AdditionalAssessmentInformation

Additional information provided in the assessment.

Example
{
  "id": "integer (int64)",
  "assessmentDate": "integer (int32)",
  "speciesInformation": {
    "taxonID": 10339,
    "scientificName": "Cymindis macularis",
    "family": "Carabidae",
    "order": "Coleoptera",
    "scientificNameAuthorship": "Mannerheim, 1823",
    "vernacularName": "Bredbrystet hedeløber",
    "arterDkId": "d31dcb5c-4d90-4166-b046-acf400b896bb"
  },
  "redlistCategory": {
    "category": "EN",
    "criteria": "B2ab",
    "upDownListing": "*"
  },
  "documentation": {
    "documentationScreening": "string",
    "documentationPopulationReduction": "string",
    "documentationGeographicExtent": "string",
    "documentationPopulationSize": "string",
    "documentationQuantitativeAnalysis": "string"
  },
  "habitat": {
    "overallHabitatTypes": [
      "string"
    ],
    "specificHabitatTypes": [
      "string"
    ],
    "substrates": [
      "string"
    ],
    "diets": [
      "string"
    ],
    "dietsSpecies": [
      {
        "taxonID": "integer (int64)",
        "scientificName": "string",
        "scientificNameAuthorship": "string"
      }
    ],
    "dietsGenera": [
      "string"
    ],
    "humidity": {
      "min": "integer",
      "max": "integer"
    },
    "reaction": {
      "min": "integer",
      "max": "integer"
    },
    "nutrient": {
      "min": "integer",
      "max": "integer"
    },
    "salinity": {
      "min": "integer",
      "max": "integer"
    },
    "lightCondition": {
      "min": "integer",
      "max": "integer"
    },
    "temperature": {
      "min": "integer",
      "max": "integer"
    },
    "disturbance": {
      "min": "string",
      "max": "string"
    }
  },
  "additionalInformation": {
    "yearOfFirstRecord": "integer",
    "yearOfMostRecentRecord": "integer",
    "trend": "string"
  }
}

SpeciesInformation: object

Provides the basic information about a species.

taxonID: integer (int64)

Internal ID uniquely identifying the species.

scientificName: string

Scientific name of the species

family: string

Family of the species

order: string

Order of the species

scientificNameAuthorship: string

Author

vernacularName: string

The local danish name

population: string

The specific population being assessed. This is mostly the National population, but in some cases a specific population will be assessed independently.

arterDkId: string

The arterDk ID of the species.

Example
{
  "taxonID": 10339,
  "scientificName": "Cymindis macularis",
  "family": "Carabidae",
  "order": "Coleoptera",
  "scientificNameAuthorship": "Mannerheim, 1823",
  "vernacularName": "Bredbrystet hedeløber",
  "arterDkId": "d31dcb5c-4d90-4166-b046-acf400b896bb"
}

Documentation: object

Documentation for different aspects of the assessment.

documentationScreening: string

Documentation for the screening of the species

documentationPopulationReduction: string

Documentation for assessed reductions in population

documentationGeographicExtent: string

Documentation for assessed geographic extent of the species.

documentationPopulationSize: string

Documentation for assessed population size of the species.

documentationQuantitativeAnalysis: string

Documentation for any quantitative analysis of the species.

Example
{
  "documentationScreening": "string",
  "documentationPopulationReduction": "string",
  "documentationGeographicExtent": "string",
  "documentationPopulationSize": "string",
  "documentationQuantitativeAnalysis": "string"
}

AdditionalAssessmentInformation: object

Provides a few additional pieces of information for each taxa.

yearOfFirstRecord: integer

The year the species were recorded in Denmark for the first time.

yearOfMostRecentRecord: integer

The year of the most recent record of the species in Denmark.

trend: string Increasing, Stable, Decreasing, Unknown

Provides the current trend of the population of a taxon (most often the Danish national population, but for a few species subpopulations have been assessed, see SpeciesInformation). Note that this is not based on the redlist assessment as such. It's the experts' best estimate considering the available information.

Example
{
  "yearOfFirstRecord": "integer",
  "yearOfMostRecentRecord": "integer",
  "trend": "string"
}

Habitat: object

An object containing detailed information about a species habitat.

overallHabitatTypes: string[]

List of overall habitat types refer to habitat types in broader terms, such as forest, meadow etc. (this information is only available in Danish)

string
specificHabitatTypes: string[]

List of specific habitat types refer to habitat types in more exact terms such as 'Sur Eng', 'Morbundskov' etc. (this information is only available in Danish)

string
substrates: string[]

List of substrates, for example: Ler, sand, sten etc. This is typically what a species lives ON. (this information is only available in Danish)

string
diets: string[]

List of diets. This is what a species lives OF, i.e. the carbon source. For an animal; what it eats, for a fungus; what it parasitize or have a symbiotic link to, etc. (this information is only available in Danish)

string
dietsSpecies: SpeciesSimple

If this species' diet consist of other species they are in this array.

SpeciesSimple
dietsGenera: string[]

If this species' diet is known to be more or less all species in one or more genera, these genera are listed here.

string
humidity: Interval

An interval from 1 (extremely dry) - 12 (flooded) resembling the Ellenberg Indicator Value framework (Ellenberg et al. 2001. Zeigerwerte von Pflanzen in Mitteleuropa). However these values can be present for all species, not only plants, and do represent a species' preference for soil/environment moisture.

reaction: Interval

An interval from 1 (acidic) - 9 (calcareous) resembling the Ellenberg Indicator Value framework (Ellenberg et al. 2001. Zeigerwerte von Pflanzen in Mitteleuropa). However these values can be present for all species, not only plants, and do represent a species' preference for soil or water pH.

nutrient: Interval

An interval from 1 (poor) - 9 (rich) resembling the Ellenberg Indicator Value framework (Ellenberg et al. 2001. Zeigerwerte von Pflanzen in Mitteleuropa). However these values can be present for all species, not only plants, and do represent a species' preference for nutrient availability.

salinity: Interval

An interval from 1 (low) - 9 (high) resembling the Ellenberg Indicator Value framework (Ellenberg et al. 2001. Zeigerwerte von Pflanzen in Mitteleuropa). However these values can be present for all species, not only plants, and do represent a species' preference for soil or water salinity.

lightCondition: Interval

An interval from 1 (deep shade) - 9 (always in full sun) resembling the Ellenberg Indicator Value framework (Ellenberg et al. 2001. Zeigerwerte von Pflanzen in Mitteleuropa). However these values can be present for all species, not only plants, and do represent a species' preference for light availability.

temperature: Interval

An interval from 1 (alpine/cold) - 9 (Mediterranean, warm) resembling the Ellenberg Indicator Value framework (Ellenberg et al. 2001. Zeigerwerte von Pflanzen in Mitteleuropa). However these values can be present for all species, not only plants, and do represent a species' preferred temperature conditions.

disturbance: DisturbanceInterval

An interval from "intense/often" to "close to none/never" (four steps) describing a species preference for disturbance regime.

Example
{
  "overallHabitatTypes": [
    "string"
  ],
  "specificHabitatTypes": [
    "string"
  ],
  "substrates": [
    "string"
  ],
  "diets": [
    "string"
  ],
  "dietsSpecies": [
    {
      "taxonID": "integer (int64)",
      "scientificName": "string",
      "scientificNameAuthorship": "string"
    }
  ],
  "dietsGenera": [
    "string"
  ],
  "humidity": {
    "min": "integer",
    "max": "integer"
  },
  "reaction": {
    "min": "integer",
    "max": "integer"
  },
  "nutrient": {
    "min": "integer",
    "max": "integer"
  },
  "salinity": {
    "min": "integer",
    "max": "integer"
  },
  "lightCondition": {
    "min": "integer",
    "max": "integer"
  },
  "temperature": {
    "min": "integer",
    "max": "integer"
  },
  "disturbance": {
    "min": "string",
    "max": "string"
  }
}

SpeciesSimple: object

A simple representation of a species with only the most relevant information. To get more information look up the species by scientificName.

taxonID: integer (int64)

Internal ID uniquely identifying the species

scientificName: string

Scientific name of the species

scientificNameAuthorship: string

Author

Example
{
  "taxonID": "integer (int64)",
  "scientificName": "string",
  "scientificNameAuthorship": "string"
}

Interval: object

Represents an interval of values.

min: integer

The minimum (inclusive) value of the interval.

max: integer

The maximum (inclusive) value of the interval.

Example
{
  "min": "integer",
  "max": "integer"
}

DisturbanceInterval: object

Represents an interval of disturbance values (from 'close to none/never' to 'intense/often')

min: string Close to none/never, Low/rare, Moderate/regular, Intense/often
max: string Close to none/never, Low/rare, Moderate/regular, Intense/often
Example
{
  "min": "string",
  "max": "string"
}

RedlistCategory: object

category: string

The final assigned IUCN redlist category

criteria: string

Denotes the IUCN criteria underlying the assigned redlist category

upDownListing: string

Whether the final category has been up- or down-listed and how much. This is represented by a string of * where each * represents an up- or down-listing.

Example
{
  "category": "EN",
  "criteria": "B2ab",
  "upDownListing": "*"
}

AssessmentExtendedResult: object

page: integer

The current page

pages: integer

The total number of pages

data: AssessmentExtended

A list of assessments matching the filters provided in the query (or all assessments if no filters were provided).

AssessmentExtended
Example
{
  "page": "integer",
  "pages": "integer",
  "data": [
    {
      "extended": {
        "historicNumberOfLocalities": "integer",
        "historicTrendDescription": "string",
        "native": "bool",
        "geographicExtentCrossesRegion": "bool",
        "threatenedHabitats": "array",
        "threats": "array",
        "nationalDistribution": "string",
        "totalDistribution": "string",
        "commentsForNomenclature": "string",
        "geography": {
          "extentOfOccurrence": "string",
          "areaOfOccurrence": "string",
          "numberOfLocations": "string",
          "fragmented": "string"
        },
        "population": {
          "matureIndividuals": "string",
          "reduction": {
            "amount": "string",
            "timespan": "string"
          }
        },
        "references": "string",
        "commentsForAdditionalInformation": "string",
        "additionalComments": "string"
      },
      "id": "integer (int64)",
      "assessmentDate": "integer (int32)",
      "speciesInformation": {
        "taxonID": 10339,
        "scientificName": "Cymindis macularis",
        "family": "Carabidae",
        "order": "Coleoptera",
        "scientificNameAuthorship": "Mannerheim, 1823",
        "vernacularName": "Bredbrystet hedeløber",
        "arterDkId": "d31dcb5c-4d90-4166-b046-acf400b896bb"
      },
      "redlistCategory": {
        "category": "EN",
        "criteria": "B2ab",
        "upDownListing": "*"
      },
      "documentation": {
        "documentationScreening": "string",
        "documentationPopulationReduction": "string",
        "documentationGeographicExtent": "string",
        "documentationPopulationSize": "string",
        "documentationQuantitativeAnalysis": "string"
      },
      "habitat": {
        "overallHabitatTypes": [
          "string"
        ],
        "specificHabitatTypes": [
          "string"
        ],
        "substrates": [
          "string"
        ],
        "diets": [
          "string"
        ],
        "dietsSpecies": [
          {
            "taxonID": "integer (int64)",
            "scientificName": "string",
            "scientificNameAuthorship": "string"
          }
        ],
        "dietsGenera": [
          "string"
        ],
        "humidity": {
          "min": "integer",
          "max": "integer"
        },
        "reaction": {
          "min": "integer",
          "max": "integer"
        },
        "nutrient": {
          "min": "integer",
          "max": "integer"
        },
        "salinity": {
          "min": "integer",
          "max": "integer"
        },
        "lightCondition": {
          "min": "integer",
          "max": "integer"
        },
        "temperature": {
          "min": "integer",
          "max": "integer"
        },
        "disturbance": {
          "min": "string",
          "max": "string"
        }
      },
      "additionalInformation": {
        "yearOfFirstRecord": "integer",
        "yearOfMostRecentRecord": "integer",
        "trend": "string"
      }
    }
  ]
}

AssessmentExtended:

extended: AssessmentExtendedData

Object containing extended information about the species.

Example
{
  "extended": {
    "historicNumberOfLocalities": "integer",
    "historicTrendDescription": "string",
    "native": "bool",
    "geographicExtentCrossesRegion": "bool",
    "threatenedHabitats": "array",
    "threats": "array",
    "nationalDistribution": "string",
    "totalDistribution": "string",
    "commentsForNomenclature": "string",
    "geography": {
      "extentOfOccurrence": "string",
      "areaOfOccurrence": "string",
      "numberOfLocations": "string",
      "fragmented": "string"
    },
    "population": {
      "matureIndividuals": "string",
      "reduction": {
        "amount": "string",
        "timespan": "string"
      }
    },
    "references": "string",
    "commentsForAdditionalInformation": "string",
    "additionalComments": "string"
  },
  "id": "integer (int64)",
  "assessmentDate": "integer (int32)",
  "speciesInformation": {
    "taxonID": 10339,
    "scientificName": "Cymindis macularis",
    "family": "Carabidae",
    "order": "Coleoptera",
    "scientificNameAuthorship": "Mannerheim, 1823",
    "vernacularName": "Bredbrystet hedeløber",
    "arterDkId": "d31dcb5c-4d90-4166-b046-acf400b896bb"
  },
  "redlistCategory": {
    "category": "EN",
    "criteria": "B2ab",
    "upDownListing": "*"
  },
  "documentation": {
    "documentationScreening": "string",
    "documentationPopulationReduction": "string",
    "documentationGeographicExtent": "string",
    "documentationPopulationSize": "string",
    "documentationQuantitativeAnalysis": "string"
  },
  "habitat": {
    "overallHabitatTypes": [
      "string"
    ],
    "specificHabitatTypes": [
      "string"
    ],
    "substrates": [
      "string"
    ],
    "diets": [
      "string"
    ],
    "dietsSpecies": [
      {
        "taxonID": "integer (int64)",
        "scientificName": "string",
        "scientificNameAuthorship": "string"
      }
    ],
    "dietsGenera": [
      "string"
    ],
    "humidity": {
      "min": "integer",
      "max": "integer"
    },
    "reaction": {
      "min": "integer",
      "max": "integer"
    },
    "nutrient": {
      "min": "integer",
      "max": "integer"
    },
    "salinity": {
      "min": "integer",
      "max": "integer"
    },
    "lightCondition": {
      "min": "integer",
      "max": "integer"
    },
    "temperature": {
      "min": "integer",
      "max": "integer"
    },
    "disturbance": {
      "min": "string",
      "max": "string"
    }
  },
  "additionalInformation": {
    "yearOfFirstRecord": "integer",
    "yearOfMostRecentRecord": "integer",
    "trend": "string"
  }
}

AssessmentExtendedData: object

historicNumberOfLocalities: integer

The number of localities at which the species have been known to live historically

historicTrendDescription: string

The historic trend described in words (this information is only available in Danish)

native: bool

Is the species native to Denmark.

geographicExtentCrossesRegion: bool

True if the species' distribution limit goes through Denmark. False otherwise.

threatenedHabitats: array

A list habitats on which the species is threatened.

threats: array

A list of the threats of the species.

nationalDistribution: string

A description of the current national distribution (this information is only available in Danish)

totalDistribution: string

A description of the current global distribution (this information is only available in Danish)

commentsForNomenclature: string

Comments for the nomenclature

geography: Geography

Details of the geoprahic information on the species.

population: Population

Details of the population information on the species.

references: string

An overview of the references used for this assessment. Note that this is not always present here, in which case the reference list used for the assessments of the whole species group is provided elsewhere on the Danish official redlist website.

commentsForAdditionalInformation: string

Comments relating to the additional information provided

additionalComments: string

Any general information or comments relating to the species

Example
{
  "historicNumberOfLocalities": "integer",
  "historicTrendDescription": "string",
  "native": "bool",
  "geographicExtentCrossesRegion": "bool",
  "threatenedHabitats": "array",
  "threats": "array",
  "nationalDistribution": "string",
  "totalDistribution": "string",
  "commentsForNomenclature": "string",
  "geography": {
    "extentOfOccurrence": "string",
    "areaOfOccurrence": "string",
    "numberOfLocations": "string",
    "fragmented": "string"
  },
  "population": {
    "matureIndividuals": "string",
    "reduction": {
      "amount": "string",
      "timespan": "string"
    }
  },
  "references": "string",
  "commentsForAdditionalInformation": "string",
  "additionalComments": "string"
}

Geography: object

extentOfOccurrence: string

An approximation of the extent of occurrence of the species in sq. km.

areaOfOccurrence: string

An approximation of the area of occurrence of the species in sq. km.

numberOfLocations: string

An approximation of the number of locations the species.

fragmented: string

Whether the species is fragmented or not.

Example
{
  "extentOfOccurrence": "string",
  "areaOfOccurrence": "string",
  "numberOfLocations": "string",
  "fragmented": "string"
}

Population: object

matureIndividuals: string

An approximation of the number of mature individuals of the species.

reduction: object
amount: string

An approximation of the population reduction in the specified timespan.

timespan: string

The timespan the population reduction will/has occur(red) in.

Example
{
  "matureIndividuals": "string",
  "reduction": {
    "amount": "string",
    "timespan": "string"
  }
}

AssessmentSummaryResult: object

page: integer

The current page

pages: integer

The total number of pages

total: integer

The total number of assignments

data: AssessmentSummaryData

A list of assessments matching the filters provided in the query (or all assessments if no filters were provided).

AssessmentSummaryData
Example
{
  "page": 1,
  "pages": 1,
  "total": 2,
  "data": [
    {
      "taxonId": 37733,
      "scientificName": "Amanita regalis",
      "vernacularName": "Brun fluesvamp",
      "family": "Agaricaceae",
      "order": "Agaricales",
      "overallSpeciesGroup": "Svampe",
      "redlistCategory": "EN",
      "arterDkId": "d31dcb5c-4d90-4166-b046-acf400b896bb"
    },
    {
      "taxonId": 1431,
      "scientificName": "Amara crenata",
      "vernacularName": "Smal ovalløber",
      "redlistCategory": "CR",
      "family": "Carabidae",
      "order": "Coleoptera",
      "overallSpeciesGroup": "Biller",
      "arterDkId": "698211f4-f785-ea11-aa77-501ac539d1ea"
    }
  ]
}

AssessmentSummaryData: object

taxonId: integer

Id of the species.

scientificName: string

Scientific name of the species

vernacularName: string

Vernacular name of the species

redlistCategory: string

The assessed redlist category of the species

family: string

The family of the species.

order: string

The taxonomic order of the species.

overallSpeciesGroup: string

The species group of the species.

arterDkId: string

The arterDk ID of the species.

Example
{
  "taxonId": "integer",
  "scientificName": "string",
  "vernacularName": "string",
  "redlistCategory": "string",
  "family": "string",
  "order": "string",
  "overallSpeciesGroup": "string",
  "arterDkId": "string"
}
Documentation by Spectacle