avesperu

avesperu gives R users a local, versioned checklist of the birds of Peru and tools to find and reconcile scientific names. It supports reproducible work on field records, biodiversity databases, and taxonomic reviews without requiring an internet connection for ordinary searches.

The bundled aves_peru_2026_v1 checklist contains 1,925 species and follows the Unión de Ornitólogos del Perú (UNOP) list dated 23 March 2026. It combines the checklist with exact and approximate matching for practical data cleaning.

Get started

Install the released package from CRAN:

install.packages("avesperu")

Or install the development version:

# pak::pak("PaulESantos/avesperu")
install.packages("avesperu", repos = c('https://paulesantos.r-universe.dev', 'https://cloud.r-project.org'))

Search a short list of submitted names:

library(avesperu)
result <- search_avesperu(
  c("Falco sparverius", "Tinamus osgoodi"),
  return_details = TRUE
)
result[, c("name_submitted", "accepted_name", "status", "dist")]
#>     name_submitted    accepted_name    status dist
#> 1 Falco sparverius Falco sparverius Residente    0
#> 2  Tinamus osgoodi  Tinamus osgoodi Residente    0

The result preserves the submitted name and returns the accepted name, status, and taxonomy. For a visual workflow, launch the interactive Shiny app:

run_avesperu_app()

Screenshot of the avesperu Shiny app for validating scientific names

What you can do

Search the current Peru checklist with search_avesperu() and retrieve taxonomic details for one name or a vector of names.
Reconcile spelling variants with controlled approximate matching; see the approximate matching guide.
Validate field-data workflows while keeping submitted values and review information; see advanced use.
Compare checklist releases in the existing 2025–2026 comparison.
Review and export batches interactively with the local Shiny application.

Scope and source

avesperu covers the bird species checklist of Peru distributed by UNOP. It is not an authority for records outside Peru, and approximate matches should be reviewed before being accepted in a dataset. Tied candidates and qualified or hybrid names are deliberately flagged for review rather than silently resolved.

The source is the Lista de las aves del Perú / List of the Birds of Peru, maintained by UNOP. This release is based on version 23-03-2026; inspect the bundled data directly with aves_peru_2026_v1, or run unop_check_update() when you intentionally want to compare the local date with the online source.

Learn more

Citation and contact

Use citation("avesperu") to obtain the current package and checklist citations. Please cite both the package and the UNOP checklist when it informs your work. The package is released under the MIT license; questions and bug reports are welcome through the issue tracker.