University of Manchester Presentation API

openapi: 3.2.0
info:
  title: University of Manchester Digital Collections — IIIF…
  version: '2.1'
  summary: Institution-operated IIIF Presentation API 2.1 over the John Rylands Library digitised collections.
  description: Manchester Digital Collections publishes the University of Manchester Library's digitised manuscripts, archives and rare books as IIIF Presentation API 2.1 documents.
  contact:
    name: The University of Manchester Library
    url: https://www.digitalcollections.manchester.ac.uk/about/
  license:
    name: See per-manifest attribution and terms
    url: https://www.digitalcollections.manchester.ac.uk/terms/
  termsOfService: https://www.digitalcollections.manchester.ac.uk/terms/
servers:
- url: https://www.digitalcollections.manchester.ac.uk
  description: Manchester Digital Collections (University of Manchester Library)
tags:
- name: Presentation
  description: IIIF Presentation API 2.1 manifests and collections.
paths:
  /iiif/{documentId}:
    get:
      tags:
      - Presentation
      operationId: getManifest
      summary: Retrieve a IIIF Presentation 2.1 manifest
      description: Returns the sc:Manifest for one digitised item. Verified live on 2026-08-19 against MS-LATIN-00006 ("Petrus Lombardus Super Psalmos (Latin MS 6)"), which returned 200 with a 378 KB manifest containing a single sequence of 398 canvases. Each canvas image resource carries a IIIF Image API 2 service pointing at image.digitalcollections.manchester.ac.uk.
      parameters:
      - name: documentId
        in: path
        required: true
        description: Collection-scoped document identifier, e.g. MS-LATIN-00006.
        schema:
          type: string
          pattern: ^[A-Za-z0-9-]+$
          examples:
          - MS-LATIN-00006
      responses:
        '200':
          description: A IIIF Presentation 2.1 manifest.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Manifest'
              examples:
                msLatin6:
                  summary: Latin MS 6 (truncated)
                  externalValue: examples/university-of-manchester-iiif-manifest-example.json
        '404':
          description: No such document. Verified with a negative probe against /iiif/NOT-A-REAL-ID-12345, which returned a genuine 404 rather than a soft-404 body.
          content:
            text/html:
              schema:
                type: string
  /iiif/collection/{collectionId}:
    get:
      tags:
      - Presentation
      operationId: getCollection
      summary: Retrieve a IIIF Presentation 2.1 collection
      description: Returns the sc:Collection listing every manifest in one named collection. Verified live on 2026-08-19 against `latin`, which returned 200 with "Latin Manuscripts" and 61 manifest references. Collection identifiers are the slugs listed at /collections/ — arabic, bibleillustrations, chinese, cunard, dante, hebrew, latin, maps, maryhamilton and others.
      parameters:
      - name: collectionId
        in: path
        required: true
        description: Collection slug as published at /collections/.
        schema:
          type: string
          pattern: ^[a-z0-9-]+$
          examples:
          - latin
      responses:
        '200':
          description: A IIIF Presentation 2.1 collection.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Collection'
        '404':
          description: No such collection.
          content:
            text/html:
              schema:
                type: string
components:
  schemas:
    Collection:
      type: object
      required:
      - '@context'
      - '@id'
      - '@type'
      properties:
        '@context':
          type: string
          const: http://iiif.io/api/presentation/2/context.json
        '@id':
          type: string
          format: uri
        '@type':
          type: string
          const: sc:Collection
        label:
          type: string
        description:
          type: string
        manifests:
          type: array
          items:
            type: object
            properties:
              '@id':
                type: string
                format: uri
              '@type':
                type: string
                const: sc:Manifest
              label:
                type: string
    Canvas:
      type: object
      properties:
        '@id':
          type: string
          format: uri
        '@type':
          type: string
          const: sc:Canvas
        label:
          type: string
        width:
          type: integer
        height:
          type: integer
        images:
          type: array
          items:
            $ref: '#/components/schemas/Annotation'
    ImageService:
      type: object
      description: Reference to the companion IIIF Image API 2 service, described in openapi/university-of-manchester-iiif-image-api-openapi.yml.
      properties:
        '@context':
          type: string
          const: http://iiif.io/api/image/2/context.json
        '@id':
          type: string
          format: uri
        profile:
          type: string
          const: http://iiif.io/api/image/2/level1.json
    Annotation:
      type: object
      properties:
        '@type':
          type: string
          const: oa:Annotation
        motivation:
          type: string
          const: sc:painting
        true:
          type: string
          format: uri
        resource:
          type: object
          properties:
            '@id':
              type: string
              format: uri
            '@type':
              type: string
              const: dctypes:Image
            format:
              type: string
            width:
              type: integer
            height:
              type: integer
            service:
              $ref: '#/components/schemas/ImageService'
    Manifest:
      type: object
      description: IIIF Presentation API 2.1 sc:Manifest, as returned by this deployment.
      required:
      - '@context'
      - '@id'
      - '@type'
      properties:
        '@context':
          type: string
          const: http://iiif.io/api/presentation/2/context.json
        '@id':
          type: string
          format: uri
        '@type':
          type: string
          const: sc:Manifest
        label:
          type: string
          description: Human-readable title of the digitised item.
        attribution:
          type: string
          description: Rights attribution string. On this deployment it always names the University of Manchester and the University of Manchester Library.
        logo:
          type: string
          format: uri
        metadata:
          type: array
          items:
            type: object
            properties:
              label:
                type: string
              value:
                type: string
        sequences:
          type: array
          items:
            $ref: '#/components/schemas/Sequence'
    Sequence:
      type: object
      properties:
        '@id':
          type: string
          format: uri
        '@type':
          type: string
          const: sc:Sequence
        canvases:
          type: array
          items:
            $ref: '#/components/schemas/Canvas'