nva

{nva} provides an R interface to the Nasjonalt Vitenarkiv (NVA) API, the Norwegian national research archive maintained by Sikt.

Installation

Install the development version from GitHub:

# install.packages("pak")
pak::pak("capro-uio/nva")

Setup

Most read and search endpoints work without authentication. For authenticated access (required for write operations and to avoid throttling), request API credentials at https://nettskjema.no/a/nva-api-tilgang and set:

Sys.setenv(
  NVA_CLIENT_ID = "your-client-id",
  NVA_CLIENT_SECRET = "your-client-secret"
)

We recommend adding these to your .Renviron file. Run nva_sitrep() to verify your setup.

Usage

library(nva)

nva_search(query = "machine learning", institution = "uio")

nva_publication("01907b24c6da-065e37af-5849-4602-b77c-d4d0d4e0ef31")

nva_person("12345")

nva_organizations(query = "Universitetet i Oslo")

To use the test/sandbox environment:

Sys.setenv(NVA_API_ENV = "test")

Diagnostics

nva_sitrep()

This checks your credentials, API connectivity, and package configuration.