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

Brown Digital Repository (BDR) API

The Brown University Library's public, keyless REST API over the Brown Digital Repository — an item API, a collection API, a Solr-backed search API, and a two-key link index at /api/. Live and unauthenticated on 2026-08-30 against an index of 1,147,400 public objects. Brown documents it itself, in prose, in the wiki of its own Brown-University-Library/bdr_api_documentation GitHub repository; there is no Brown-published OpenAPI, so the contract in this repo is derived and marked as such. Notable behaviours, all probed: rows is silently clamped to 500, malformed queries return 200 rather than the documented 400, unknown PIDs return a nine-byte text/html "Not Found" rather than the documented 403, no CORS headers are sent (JSONP via a callback parameter is the documented cross-origin path), and Cloudflare bot protection added in Spring 2025 fronts the host.

Brown Digital Repository (BDR) API is one of 7 APIs that Brown University publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Digital Repository, Research Repository, Library, Search, and Research Data. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and 1 JSON Schema.

This API exposes 5 operations across 5 paths, organized into 4 resource areas, and defines 9 schemas. It is described by OpenAPI 3.1.0, at version 2026-08-30.

Requests are made against a single base URL, https://repository.library.brown.edu.

5 operations 5 paths 9 schemas 5 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2026-08-30
Base URL
https://repository.library.brown.edu/api/
Terms of Service
Resource Areas
4

Paths & Operations 5

Across 5 paths, the API surfaces 5 operations — 5 GET. They span 4 resource areas: Discovery, Search, Items, Collections. Each is listed below with its method, path, parameters, and response codes.

Discovery 1

The API root link index.

GET
/api/
API root link index
getApiRoot → 200500
Search 1

Solr-backed search across public BDR objects.

GET
/api/search/
Search public BDR objects
searchRepository 5 params → 200400500
Items 1

Metadata for a single repository object, addressed by PID.

GET
/api/items/{pid}/
Get one repository object
getItem 1 param → 200403404500
Collections 2

Repository collections and their membership.

GET
/api/collections/
List top-level collections
listTopLevelCollections → 200500
GET
/api/collections/{collection_id}/
Get one collection, its sub-collections and its items
getCollection 2 params → 200404

Schemas 9

The contract defines 9 schemas that model the data the API accepts and returns. The most detailed are Relations (13 properties), Item (11 properties), CollectionRef (9 properties), Document (5 properties). Each schema is shown below with its type and property counts.

ApiRoot
object
The /api/ link index.
2 properties
SearchResponse
object
3 properties 2 required
Document
object
One indexed object. The field set is Solr-dynamic and varies by object type; fl= returned 50+ fields per document at probe time. Only the fields common to ever…
5 properties
Item
object
A full object record from the item API.
11 properties 1 required
ItemLinks
object
4 properties
Relations
object
Fixed set of relation predicates, each an array. Empty arrays are returned rather than omitted, so a client can rely on every key being present.
13 properties
CollectionList
object
1 property 1 required
CollectionRef
object
9 properties
Collection
object
A single collection, its sub-collections and its member items.
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

brown-bdr-api-openapi.yml Raw ↑

Other APIs Brown University publishes across the network.

Brown Digital Repository IIIF Image and Presentation API
Brown University Identity Provider (Shibboleth / SAML 2.0)
BruKnow Library Discovery (Ex Libris Primo VE tenant)
Courses@Brown (Leepfrog CourseLeaf tenant)
Brown University Bulletin (Leepfrog CourseLeaf CAT tenant)
Events@Brown (LiveWhale Calendar tenant)
Where this information came from

This is an independent, third-party profile of Brown Digital Repository (BDR) 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.