finbif-api

Guide FinBIF REST API requests with authentication, headers, and pagination.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/luomus/finbif-skills --skill finbif-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finbif-api
Source: https://github.com/luomus/finbif-skills/tree/main/finbif-api
Command: npx skills add https://github.com/luomus/finbif-skills --skill finbif-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

General guide to the FinBIF (Finnish Biodiversity Information Facility) REST API at api.laji.fi. Use this skill whenever the user mentions FinBIF, laji.fi, Finnish biodiversity data, Finnish species observations, or is building anything that queries biodiversity/nature data from Finland. Covers authentication, pagination, rate limiting, error handling, and endpoint overview. This is the starting point — read this first for any FinBIF-related task.

Core Features & Use Cases

  • Centralized API overview: authentication, headers, pagination, error handling, and endpoint navigation.
  • Use cases include taxa lookup, occurrence queries, dataset metadata, and general endpoint discovery for FinBIF-based tools.
  • The skill also clarifies when to employ specialized skills (finbif-occurrence, finbif-taxonomy, finbif-api-endpoints) for deeper tasks.

Quick Start

Provide a sample authenticated request to the FinBIF API including required headers and a simple endpoint such as /taxa

Frequently Asked Questions about finbif-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I authenticate requests to the FinBIF API at api.laji.fi?

To authenticate FinBIF API requests, include an Authorization header with required API-Version, Accept, and Accept-Language headers to successfully access Finnish biodiversity data endpoints.

What headers are required for querying Finnish biodiversity data from api.laji.fi?

Querying Finnish biodiversity data from api.laji.fi requires setting the API-Version, Accept, Accept-Language, and Authorization headers in your HTTP requests to ensure proper endpoint navigation and response formatting.

How does pagination work when querying FinBIF occurrence and taxonomy endpoints?

Pagination for FinBIF occurrence and taxonomy endpoints is handled through request parameters that offset result sets. This skill explains how to navigate these parameters and interpret responses to manage large volumes of species observations.

Can I use this skill for querying Finnish species observations and dataset metadata?

Yes, you can use this skill for querying Finnish species observations, taxa lookups, and dataset metadata. It serves as the starting point for building applications that consume FinBIF services and navigate its REST API endpoints.

What is the best way to handle rate limiting and errors from the FinBIF REST API?

Handling rate limiting and errors from the FinBIF REST API involves interpreting specific HTTP response codes returned by api.laji.fi. This skill outlines how to navigate these constraints and manage request parameters effectively.

When should I use specialized FinBIF skills instead of this general API guide?

You should use specialized FinBIF skills like finbif-occurrence or finbif-taxonomy for deeper, task-specific queries after reading this general guide. This skill clarifies when to transition from endpoint discovery to specialized biodiversity data retrieval.