GBIF icon

GBIF

GBIF provides free and open access to biodiversity data

Actions22

  • Collection Actions
  • Dataset Actions
  • Dataset Search Actions
  • Installation Actions
  • Institution Actions
  • Occurrence Actions
  • Occurrence Count Actions
  • Occurrence Search Actions
  • Occurrence Search Catalog Number Actions
  • Occurrence Search Collection Code Actions
  • Occurrence Search Occurrence ID Actions
  • Occurrence Search Recorded By Actions
  • Occurrence Search Record Number Actions
  • Occurrence Search Institution Code Actions
  • Organization Actions
  • Name Parser Actions
  • Network Actions
  • Node Actions
  • Species Actions
  • Species Match Actions
  • Species Search Actions
  • Species Suggest Actions

Organization → Get

AI-generated

Overview

This node integrates with the GBIF (Global Biodiversity Information Facility) API to retrieve biodiversity data. Specifically, for the Organization - Get operation, it fetches detailed information about an organization or its related sub-resources from the GBIF database. This is useful for users who want to access metadata about organizations involved in biodiversity data publishing and management.

Common scenarios include:

  • Retrieving details of a specific organization by its ID.
  • Accessing related sub-resources such as comments, contacts, endpoints, hosted datasets, identifiers, installations, machine tags, published datasets, or tags associated with the organization.

Practical example:

  • A researcher wants to get detailed information about a particular biodiversity organization, including its hosted datasets and contact information, to understand its contributions and collaborations.

Properties

Name Meaning
ID The unique identifier of the organization to retrieve.
Sub-Resource Optional related resource to fetch along with the organization. Options: (empty), Comment, Contact, Endpoint, Hosted Dataset, Identifier, Installation, Machine Tag, Published Dataset, Tag

Output

The node outputs a JSON array containing the response from the GBIF API for the requested organization or its sub-resource. The structure depends on the GBIF API response but generally includes detailed metadata about the organization or the selected sub-resource.

No binary data output is produced by this operation.

Example output JSON snippet (simplified):

{
  "key": "organization-id",
  "title": "Organization Name",
  "description": "Description of the organization",
  "contacts": [...],
  "hostedDatasets": [...],
  ...
}

Dependencies

  • The node makes HTTP GET requests to the public GBIF API endpoint at https://api.gbif.org/v1/organization.
  • No authentication or API keys are required for this operation.
  • Requires internet connectivity to reach the GBIF API.

Troubleshooting

  • Empty or invalid ID: If the ID property is empty or incorrect, the API will return an error or no data. Ensure the correct organization ID is provided.
  • Invalid sub-resource name: Selecting a sub-resource not supported by the API or mistyping the option may result in errors or empty responses.
  • Network issues: Connectivity problems can cause request failures. Verify network access to api.gbif.org.
  • API rate limits: Although GBIF API is public, excessive requests might be throttled. Consider adding delays or caching results if needed.

Common error messages:

  • HTTP 404 Not Found: Organization ID does not exist.
  • HTTP 400 Bad Request: Invalid parameters.
  • Network timeout or DNS resolution errors: Check internet connection.

Links and References

Discussion