Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

National Archives and Records Administration (NARA) Tags API

Tag search and data retrieval

This API exposes 6 operations across 6 paths, and defines 1 schema. It is described by OpenAPI 3.0.0, at version 0.2.0.

Requests are made against a single base URL, https://catalog.archives.gov/api/v2/.

6 operations 6 paths 1 schemas 1 DELETE4 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
0.2.0
Base URL
https://catalog.archives.gov/api/v2/
Resource Areas
1

Paths & Operations 6

Across 6 paths, the API surfaces 6 operations — 1 DELETE, 4 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Tags 6

Tag search and data retrieval

GET
/tags/search
Get search results for tag data by sending a request with search parameters to the catalog.
6 params → 200400422
GET
/tags/{id}
Get a single tag object by tag id.
2 params → 200400422
GET
/tags/naId/{naId}
Get tags by their parent record's naId.
2 params → 200422
GET
/tags/userId/{userId}
Get tags by their contributor's userId.
2 params → 200422
POST
/tags/
Add a tag.
body → 200422
DELETE
/tags/:contributionId
Deactivate/remove a tag.
4 params → 200409

Schemas 1

The contract defines 1 schema that model the data the API accepts and returns. The most detailed is tagBody (5 properties). Each schema is shown below with its type and property counts.

tagBody
object
5 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

national-archives-and-records-administration-nara--tags-api-openapi.yml Raw ↑