ChecklistBankDataset icon

ChecklistBankDataset

ChecklistBank dataset viewer

Actions14

  • Dataset Search Actions
  • Decision Actions
  • Estimate Actions
  • Metadata Actions
  • Name Actions
  • Name Usage Actions
  • Name Usage Search Actions
  • Name Usage Suggest Actions
  • Reference Actions
  • Source Metadata Actions
  • Synonym Actions
  • Taxon Actions
  • Tree Actions
  • Vernacular Actions

Taxon → Get

AI-generated

Overview

This node interacts with the ChecklistBank API to retrieve taxonomic data from various datasets. Specifically, for the Taxon - Get operation, it fetches detailed information about taxa within a specified dataset. This is useful for users who want to programmatically access taxonomic details such as species, genus, family, and other hierarchical classifications from curated biodiversity datasets.

Common scenarios include:

  • Retrieving taxon details by ID within a known dataset.
  • Paging through large sets of taxon records using offset and limit parameters.
  • Integrating taxonomic data into workflows for biodiversity research, ecological studies, or conservation projects.

Example: A researcher wants to get detailed taxon information for a particular taxon ID in a dataset identified by its key, possibly limiting results to 50 entries starting from an offset of 0.

Properties

Name Meaning
Dataset Key The unique identifier of the dataset to query (required).
Additional Fields Optional extra parameters to refine the request:
  ID The specific taxon ID to retrieve.
  Offset The paging offset for results (default 0).
  Limit Maximum number of results to return (minimum 1, default 50).

Output

The node outputs an array of JSON objects representing taxon data retrieved from the ChecklistBank API. Each object contains detailed taxonomic information corresponding to the requested dataset and taxon ID or list of taxa.

The output JSON structure directly reflects the API response, typically including fields such as taxon name, rank, status, parent taxon, and other relevant metadata.

No binary data output is produced by this node.

Dependencies

  • Requires internet access to call the ChecklistBank public API at https://api.checklistbank.org.
  • No authentication credentials are required for this node.
  • Uses standard HTTP GET requests with JSON responses.

Troubleshooting

  • Empty or no results: Ensure the correct dataset key and taxon ID are provided. Verify that the dataset exists and contains the requested taxon.
  • Invalid parameter errors: Check that numeric fields like offset and limit are valid numbers and within allowed ranges.
  • API connectivity issues: Confirm network access to api.checklistbank.org. Temporary API downtime may cause failures.
  • Rate limiting or throttling: If many requests are made rapidly, the API might throttle requests. Implement delays or retries if needed.

Links and References

Discussion