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) Transcriptions API

Transcription search and data retrieval

This API exposes 9 operations across 7 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/.

9 operations 7 paths 1 schemas 1 DELETE4 GET3 POST1 PUT

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 9

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

Transcriptions 9

Transcription search and data retrieval

GET
/transcriptions/search
Get search results for transcriptions data by sending a request with search parameters to the catalog.
6 params → 200400422
GET
/transcriptions/{id}
Get a single transcription object by transcription id.
2 params → 200422
GET
/transcriptions/naId/{naId}
Get transcriptions by their parent record's naId.
2 params → 200422
GET
/transcriptions/userId/{userId}
Get transcriptions by their contributor's userId.
2 params → 200422
PUT
/transcriptions/
Add or update a transcription.
1 param body → 200400422
POST
/transcriptions/
Add a transcription.
body → 200400422
POST
/transcriptions/history/:parentContributionId
Get the history of a transcription.
1 param → 200400
DELETE
/transcriptions/:contributionId/justificationId/:justificationId
Deactivate a transcription.
5 params → 200409
POST
/transcriptions/:contributionId/justificationId/:justificationId
Activate a transcription.
3 params → 200403409

Schemas 1

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

transcriptionBody
object
5 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

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