openapi: 3.2.0
info:
  title: Brown Digital Repository and Presentation IIIF Image API
  version: '2026-08-30'
  summary: Brown University Library's IIIF Image API 2.x and Presentation API 2.x surface over the BDR.
  description: 'The Brown Digital Repository serves its images through the International Image Interoperability

    Framework.'
  contact:
    name: Brown University Library
    url: https://library.brown.edu
  x-operator: institution
  x-operator-basis: Same host and same application as the BDR API — `repository.library.brown.edu`, under Brown's own registrable domain, running Brown University Library software. IIIF is a community specification, not a vendor platform; serving it does not make the surface someone else's.
  x-provenance:
    generated: '2026-08-30'
    method: derived
    source:
    - https://repository.library.brown.edu/api/items/bdr:80246/
    - https://repository.library.brown.edu/iiif/image/bdr:80246/info.json
    - https://repository.library.brown.edu/iiif/presentation/bdr:80246/manifest.json
    - https://iiif.io/guides/guides/repository.library.brown.edu/
    note: Derived from live probes on 2026-08-30 plus the IIIF community's own case-study guide for repository.library.brown.edu. Not published by Brown as a specification.
servers:
- url: https://repository.library.brown.edu
  description: Brown Digital Repository production
security: []
tags:
- name: IIIF Image
  description: IIIF Image API 2.x — image information and derivative delivery.
paths:
  /iiif/image/{pid}/info.json:
    get:
      tags:
      - IIIF Image
      operationId: getIiifImageInfo
      summary: IIIF Image API 2.x image information document
      description: Returns the image information document for a BDR object's image. Confirmed live for `bdr:80246`, which reports a 6335x8560 source with a seven-step size pyramid down to 99x134 and 512x512 tiles.
      parameters:
      - name: pid
        in: path
        required: true
        description: BDR persistent identifier for the object whose image is being described.
        schema:
          type: string
          pattern: ^bdr:[A-Za-z0-9]+$
        example: bdr:80246
      responses:
        '200':
          description: IIIF Image information document
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImageInfo'
        '404':
          description: Not Found. Observed for a PID with no image derivative — `bdr:1002496`, a video object, returned 404 here while returning 200 from the item API. Presence in the repository does not imply presence on the IIIF surface.
  /iiif/image/{pid}/{region}/{size}/{rotation}/{quality}.{format}:
    get:
      tags:
      - IIIF Image
      operationId: getIiifImage
      summary: IIIF Image API 2.x image request
      description: Standard IIIF Image API 2.x request syntax. Parameter semantics are the IIIF specification's, not Brown's; the supported sizes and tile geometry for a given object are declared by that object's info.json.
      parameters:
      - name: pid
        in: path
        required: true
        description: BDR persistent identifier, used as the IIIF image identifier.
        schema:
          type: string
        example: bdr:80246
      - name: region
        in: path
        required: true
        description: 'IIIF region selector: full, square, x,y,w,h or pct:x,y,w,h.'
        schema:
          type: string
        example: full
      - name: size
        in: path
        required: true
        description: 'IIIF size selector: full, max, w,, ,h, w,h or pct:n. Sizes the object actually holds are listed in its info.json.'
        schema:
          type: string
        example: 792,
      - name: rotation
        in: path
        required: true
        description: Clockwise rotation in degrees, optionally prefixed with ! to mirror first.
        schema:
          type: string
        example: '0'
      - name: quality
        in: path
        required: true
        description: IIIF image quality.
        schema:
          type: string
          enum:
          - default
          - color
          - gray
          - bitonal
        example: default
      - name: format
        in: path
        required: true
        description: Output format. Availability per object is declared in its info.json.
        schema:
          type: string
          enum:
          - jpg
          - png
          - tif
          - gif
          - jp2
          - pdf
          - webp
        example: jpg
      responses:
        '200':
          description: Image derivative
          content:
            image/jpeg:
              schema:
                type: string
                format: binary
        '400':
          description: Malformed IIIF request, per IIIF Image API 2.x.
        '404':
          description: Unknown identifier or unsupported derivative.
components:
  schemas:
    ImageInfo:
      type: object
      description: IIIF Image API 2.x information document, as observed.
      additionalProperties: true
      properties:
        '@context':
          type: string
          const: http://iiif.io/api/image/2/context.json
        '@id':
          type: string
          format: uri
        protocol:
          type: string
          const: http://iiif.io/api/image
        width:
          type: integer
        height:
          type: integer
        sizes:
          type: array
          items:
            type: object
            properties:
              width:
                type: integer
              height:
                type: integer
        tiles:
          type: array
          items:
            type: object
            properties:
              width:
                type: integer
              height:
                type: integer
              scaleFactors:
                type: array
                items:
                  type: integer
x-access:
  authentication: none
  description: Anonymous and keyless for public objects, matching the BDR API.