University of Bristol data-set API

openapi: 3.0.1
info:
  title: Pure data-set API
  description: The Pure API provides a secure and complete web services API for using and managing research information data in Pure. This OpenAPI description is a faithful, read-oriented subset of the University of Bristol Research Portal (Pure, by Elsevier) API as published at https://research-information.bris.ac.uk/ws/api, focused on the core Open Data collections (research outputs, persons, projects, datasets) and their canonical item lookups. The upstream specification (Pure 5.34.1) exposes 608 paths and the full Pure model; this document keeps only the real paths and schemas confirmed against the live spec.
  version: 5.34.1
  contact:
    email: pure-support@bristol.ac.uk
servers:
- url: https://research-information.bris.ac.uk/ws/api
  description: University of Bristol Research Portal (Pure) API
security:
- api-key: []
tags:
- name: data-set
paths:
  /data-sets:
    get:
      tags:
      - data-set
      summary: Lists all datasets
      operationId: dataSet_list
      parameters:
      - $ref: '#/components/parameters/size'
      - $ref: '#/components/parameters/offset'
      - $ref: '#/components/parameters/order'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataSetListResult'
        default:
          $ref: '#/components/responses/Problem'
  /data-sets/{uuid}:
    get:
      tags:
      - data-set
      summary: Get dataset
      operationId: dataSet_get
      parameters:
      - $ref: '#/components/parameters/uuid'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataSet'
        default:
          $ref: '#/components/responses/Problem'
components:
  schemas:
    SystemLocalizedString:
      type: object
      additionalProperties: true
      description: System-localized string value keyed by locale.
    DataSetListResult:
      type: object
      properties:
        count:
          type: integer
          format: int32
        pageInformation:
          $ref: '#/components/schemas/PageInformation'
        items:
          type: array
          items:
            $ref: '#/components/schemas/DataSet'
    PageInformation:
      type: object
      properties:
        offset:
          type: integer
          format: int32
        size:
          type: integer
          format: int32
    ProblemDetails:
      type: object
      properties:
        type:
          type: string
        title:
          type: string
        status:
          type: integer
          format: int32
        detail:
          type: string
        instance:
          type: string
    LocalizedString:
      type: object
      additionalProperties: true
      description: Map of locale code to string value.
    DataSet:
      type: object
      required:
      - title
      - type
      - managingOrganization
      - publisher
      - persons
      - visibility
      properties:
        pureId:
          type: integer
          format: int64
        uuid:
          type: string
          format: uuid
        createdBy:
          type: string
        createdDate:
          type: string
          format: date-time
        modifiedBy:
          type: string
        modifiedDate:
          type: string
          format: date-time
        portalUrl:
          type: string
        version:
          type: string
        title:
          $ref: '#/components/schemas/LocalizedString'
        type:
          $ref: '#/components/schemas/ClassificationRef'
        totalNumberOfAuthors:
          type: integer
          format: int32
        openAireCompliant:
          type: boolean
        license:
          $ref: '#/components/schemas/ClassificationRef'
        systemName:
          type: string
    ClassificationRef:
      type: object
      required:
      - uri
      properties:
        uri:
          type: string
        term:
          $ref: '#/components/schemas/SystemLocalizedString'
  parameters:
    size:
      name: size
      in: query
      description: Number of returned items per request.
      schema:
        type: integer
        format: int32
        maximum: 1000
        default: 10
    uuid:
      name: uuid
      in: path
      required: true
      description: UUID or known identifier of the content.
      schema:
        type: string
    order:
      name: order
      in: query
      description: The order of the list, must be a value from the matching /orderings endpoint.
      schema:
        type: string
    offset:
      name: offset
      in: query
      description: The offset for the returned list. 0 or null value is from the start.
      schema:
        type: integer
        format: int32
        default: 0
  responses:
    Problem:
      description: Error response
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ProblemDetails'
  securitySchemes:
    api-key:
      type: apiKey
      description: Security mechanism for the API
      name: api-key
      in: header