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 Usage → 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 Usage" resource with the "Get" operation allows users to retrieve detailed information about specific name usages in taxonomy.

Typical use cases include:

  • Fetching taxonomic details for a given scientific name or taxon.
  • Searching for name usages filtered by rank or query parameters.
  • Paging through large sets of taxonomic data.

For example, a researcher could use this node to get all name usages classified under a particular taxonomic rank such as "Genus" or "Species," or to look up a specific name usage by its ID.

Properties

Name Meaning
Additional Fields A collection of optional fields to refine the request:
- ID The unique identifier of the name usage to retrieve.
- Query (q) A search string to filter name usages by matching text.
- Rank The taxonomic rank to filter results by. Options include a comprehensive list from Domain to Form.
- Offset The paging offset to start returning results from (default 0).
- Limit Maximum number of results to return (minimum 1, default 50).

The "Rank" property supports many options representing taxonomic ranks, such as Domain, Kingdom, Phylum, Class, Order, Family, Genus, Species, Subspecies, Variety, Form, and many others, allowing precise filtering of taxonomic data.

Output

The node outputs an array of JSON objects corresponding to the retrieved name usage records from the ITIS API. Each object contains detailed taxonomic information as returned by the API, including identifiers, names, ranks, and other metadata relevant to the name usage.

No binary data output is produced by this node.

Dependencies

  • This node requires internet access to call the ITIS API at https://api.checklistbank.org/dataset/2144.
  • No authentication credentials are required for this API.
  • The node uses standard HTTP GET requests with JSON responses.

Troubleshooting

  • Empty Results: If no data is returned, verify that the ID or query parameters are correct and that the rank filter matches existing data.
  • Invalid Rank Option: Ensure the rank value is one of the supported options; otherwise, the API may reject the request.
  • Paging Issues: When using offset and limit, ensure offset is not negative and limit is at least 1.
  • Network Errors: Check internet connectivity and API availability if requests fail.
  • API Changes: Since the node relies on an external API, changes in the API endpoints or response format may cause errors.

Links and References

This summary focuses specifically on the "Name Usage" resource with the "Get" operation as requested.

Discussion