How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Digitised Objects Repository Search and Data API

A single point-of-truth interface for searching, browsing and displaying the digitised objects held in Newcastle University Library's Special Collections. Eighteen operations across collections, digitised objects, items, search, autocomplete, transcripts, IIIF image delivery, TEI content and CONTENTdm identifier resolution. Open, unauthenticated, HATEOAS-linked, and it publishes its own OpenAPI and build number from a machine-readable /info endpoint. Verified live 2026-08-30 serving 15,482 digitised objects.

Digitised Objects Repository Search and Data API is one of 8 APIs that Newcastle University publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 4 JSON Schema definitions.

Tagged areas include Digital Library, Cultural Heritage, Search, and Repository. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, and 4 JSON Schemas.

This API exposes 18 operations across 18 paths, organized into 3 resource areas, and defines 15 schemas. It is described by OpenAPI 3.0.0, at version 1.27.0.

Requests are made against a single base URL, https://api-dor.ncl.ac.uk.

18 operations 18 paths 15 schemas 18 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.27.0
Base URL
https://api-dor.ncl.ac.uk
Resource Areas
3

Paths & Operations 18

Across 18 paths, the API surfaces 18 operations — 18 GET. They span 3 resource areas: API Metadata Information, Digitised Objects, V1. Each is listed below with its method, path, parameters, and response codes.

API Metadata Information 3

A set of endpoints for gathering information about the API itself. They can be used for validation, creating types or checking if the service is live.

GET
/
The API's home page
getHome → 2005XX
GET
/info
The API's information
getInfo → 2005XX
GET
/info/open-api
The OpenAPI specification
getInfoOpenAPI → 2005XX
Digitised Objects 1

A set of endpoints describing the digitised objects present in the repository.

GET
/iiif/{id}
IIIF permalink
getIIIF 1 param → 3024004045XX
V1 14

A set of endpoints created as as part of the version one of the application.

GET
/v1/collections
List of collections
getV1CollectionsIndex 3 params → 2004005XX
GET
/v1/collections/{id}
Collection definition
getV1CollectionsShow 1 param → 2004004045XX
GET
/v1/digitised-objects
List of digitised objects
getV1DigitisedObjectsIndex 3 params → 2004005XX
GET
/v1/digitised-objects/search
Search digitised objects
getV1DigitisedObjectsSearch 15 params → 2004004045XX
GET
/v1/digitised-objects/search/autocomplete
Search digitised objects autocompletion
getV1DigitisedObjectsSearchAutocomplete 3 params → 2004004045XX
GET
/v1/digitised-objects/{id}
Digitised object definition
getV1DigitisedObjectsShow 1 param → 2004004045XX
GET
/v1/digitised-objects/{id}/transcript/content
Digitised object's transcript
getV1DigitisedObjectsTranscriptContent 1 param → 2004004045XX
GET
/v1/items
List of items
getV1ItemsIndex 3 params → 2004005XX
GET
/v1/items/search
Search items
getV1ItemsSearch 17 params → 2004004045XX
GET
/v1/items/search/autocomplete
Search items autocompletion
getV1ItemsSearchAutocomplete 3 params → 2004004045XX
GET
/v1/items/{id}/{position}
Item definition
getV1ItemsShow 2 params → 2004004045XX
GET
/v1/items/{id}/{position}/transcript/content
Item's transcript
getV1ItemsTranscriptContent 2 params → 2004004045XX
GET
/v1/contentdm/{collectionId}/{itemId}
CONTENTdm reverse mapping
getV1Contentdm 2 params → 3024004045XX
GET
/v1/tei/{id}/content
TEI Document Content
getV1TEIContent 1 param → 3024004045XX

Schemas 15

The contract defines 15 schemas that model the data the API accepts and returns. The most detailed are Pagination (5 properties), FilterOption (5 properties), Facet (4 properties), FilterValue (3 properties). Each schema is shown below with its type and property counts.

Version
string
A representation of a version compatible with [Semantic Versioning 2.0.0](https://semver.org/).
HateoasParameters
object
Any relevant parameters that should be appended to the URL (for GET method) or passed as a payload for other HTTP methods.
HateoasLink
object
3 properties 2 required
HomeLinks
object
Standard set of links related to the homepage.
1 property 1 required
Pagination
object
Defines the metadata for the pagination used for providing the data on the given endpoint.
5 properties 5 required
SortOption
object
3 properties 3 required
Sort
object
3 properties 3 required
Facet
object
4 properties 3 required
FilterValue
object
3 properties 3 required
FilterOption
object
5 properties 5 required
Filters
object
2 properties 2 required
StringOrArrayOfStrings
ReadonlyQuery
object
1 property 1 required
CancellableQuery
object
AutocompleteResponse
object
3 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

newcastle-digitised-objects-api-openapi.yml Raw ↑

Other APIs Newcastle University publishes across the network.

ECPPEC Electoral Data GraphQL API
Newcastle University eTheses OAI-PMH Endpoint
data.ncl Research Data Repository (Figshare tenancy)
Urban Observatory API (Urban Sciences Building) — Entity
Urban Observatory API (Urban Sciences Building) — Feed
Urban Observatory API (Urban Sciences Building) — Summary
Urban Observatory API (Urban Sciences Building) — Timeseries
Where this information came from

This is an independent, third-party profile of Digitised Objects Repository Search and Data API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.