ITIS icon

ITIS

Authoritative taxonomic information on plants, animals, fungi, and microbes of North America and the world

Actions9

  • Name Actions
  • Name Usage Actions
  • Name Usage Search Actions
  • Name Usage Suggest Actions
  • Reference Actions
  • Synonym Actions
  • Taxon Actions
  • Tree Actions
  • Vernacular Actions

Name → Get

AI-generated

Overview

This node integrates with the ITIS (Integrated Taxonomic Information System) API, providing authoritative taxonomic information on plants, animals, fungi, and microbes primarily from North America and worldwide. The "Name" resource with the "Get" operation allows users to retrieve detailed information about a specific taxonomic name or a list of names.

Typical use cases include:

  • Fetching taxonomic details for a given scientific name or taxon.
  • Retrieving paginated lists of names for biodiversity data analysis.
  • Integrating taxonomic data into workflows for research, environmental monitoring, or educational purposes.

For example, a user might input an ID corresponding to a species name to get its full taxonomic record or request a list of names with pagination controls.

Properties

Name Meaning
Additional Fields Collection of optional parameters:
- ID The unique identifier for the name, taxon, or synonym to fetch.
- Offset The paging offset for results, allowing retrieval of subsequent pages in a result set.
- Limit Maximum number of results to return (minimum 1).

Output

The node outputs a JSON array containing the response data from the ITIS API for the requested name(s). This typically includes detailed taxonomic information such as scientific names, synonyms, taxonomic hierarchy, and related metadata depending on the ID or query parameters provided.

No binary data output is produced by this node.

Dependencies

  • External API: The node requires access to the ITIS API endpoint at https://api.checklistbank.org/dataset/2144.
  • No authentication credentials are required for this resource-operation combination.
  • Network connectivity to the ITIS API must be available.

Troubleshooting

  • Common Issues:

    • Invalid or missing ID in Additional Fields may result in empty or error responses.
    • Exceeding API rate limits or network issues can cause request failures.
    • Providing an offset or limit outside valid ranges may lead to unexpected results or errors.

  • Error Messages:

    • HTTP errors from the ITIS API (e.g., 404 Not Found if ID does not exist).
    • Timeout or connection errors if the API endpoint is unreachable.

  • Resolutions:

    • Verify that the ID parameter is correct and corresponds to an existing taxonomic name.
    • Adjust offset and limit values within allowed ranges.
    • Ensure stable internet connection and retry after some time if rate-limited.

Links and References

Discussion