openapi: 3.0.2
info:
  title: Discovery bitstreams ETH Research Collection API V2 API
  description: "The Discovery REST API provides access to over 30 million books, images, series, journals, and other materials from the ETH Library's Discovery Portal. \n\n➜ [OAS 3 Swagger Documentation](https://eth-library.github.io/apiplatform-swagger/discovery/v1/)\n\n➜ [ETH Library @ swisscovery Application](https://eth.swisscovery.slsp.ch/)"
  version: 1.0.2
  termsOfService: https://developer.library.ethz.ch/terms
  contact:
    name: API Management ETH Library
    email: api@library.ethz.ch
    url: https://library.ethz.ch
  license:
    url: https://developer.library.ethz.ch/terms
    name: Bibliographic metadata that are not specifically marked are free for general use (Public Domain). Documents, images or other digital objects linked in metadata may be subject to other copyright restrictions. Whenever possible, the licence of the referenced digital objects is indicated in the metadata. In case of doubt, the licence can be inquired at api@library.ethz.ch.
servers:
- url: https://api.library.ethz.ch/discovery/v1/
  description: Production
security:
- ApiKeyAuth: []
tags:
- name: ETH Research Collection API V2
paths:
  /:
    get:
      summary: Retrieve API root information
      description: Returns general information about the DSpace instance and available API endpoints.
      responses:
        '200':
          description: Successful response with API root information
          content:
            application/json:
              schema:
                type: object
                properties:
                  dspaceUI:
                    type: string
                  dspaceName:
                    type: string
                  dspaceServer:
                    type: string
                  dspaceVersion:
                    type: string
                  type:
                    type: string
                  _links:
                    type: object
                    additionalProperties:
                      type: object
                      properties:
                        href:
                          type: string
      tags:
      - ETH Research Collection API V2
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: query
      name: apikey
externalDocs:
  description: OAS 3 Swagger Documentation
  url: https://apidocs.library.ethz.ch/discovery/v1/