PHAIDRA lists API (University of Vienna)

Requests for manipulating object lists

Operations 9

GET /list/token/{token} Get object list exposed under specified token.
GET /lists Get user's object lists
GET /list/{lid} Get list detail
POST /list/add Add list
POST /list/{lid}/token/create Create a list token
POST /list/{lid}/token/delete Delete list token
POST /list/{lid}/remove Remove list
POST /list/{lid}/members/add Add objects to list
POST /list/{lid}/members/remove Remove objects from list

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/university-of-vienna-lists-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

university-of-vienna-lists-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: PHAIDRA datastream Lists API
  version: '3.0'
  description: Documentation of the PHAIDRA API.
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  x-provenance:
    generated: '2026-08-30'
    method: searched
    source: >-
      PHAIDRA API v3.0, published Apache 2.0 by the PHAIDRA project (github.com/phaidra/phaidra-api, public/docs/openapi.json), the platform the University of Vienna authors and hosts. Pristine copy at
      openapi/_original/university-of-vienna-phaidra-api.yaml.
    x-operator: institution
    note: >-
      Split from the source contract by refine-openapis; servers[] re-based to the live production host on 2026-08-30 (see servers[].description).
servers:
- url: https://phaidra.univie.ac.at/api/
  description: University of Vienna PHAIDRA (current production base, re3data r3d100010472, verified 2026-08-30)
- description: RETIRED — returns HTTP 200 with a zero-length body on every path (soft-200), verified 2026-08-30
  url: https://services.phaidra.univie.ac.at/api/
- description: PHAIDRA Sandbox — connection timed out on probe 2026-08-30
  url: https://sandbox.phaidra.org/api/
tags:
- name: lists
  description: Requests for manipulating object lists
paths:
  /list/token/{token}:
    get:
      summary: Get object list exposed under specified token.
      tags:
      - lists
      parameters:
      - in: path
        name: token
        schema: {}
        description: the requested token no
      responses:
        '200':
          description: list detail
          content:
            application/json:
              schema:
                type: object
                properties:
                  alerts:
                    type: array
                    items:
                      type: object
                      properties:
                        msg:
                          type: string
                        type:
                          type: string
                  list:
                    $ref: '#/components/schemas/group'
  /lists:
    get:
      summary: Get user's object lists
      tags:
      - lists
      security:
      - basicAuth: []
      responses:
        '200':
          description: lists
          content:
            application/json:
              schema:
                type: object
                properties:
                  alerts:
                    type: array
                    items:
                      type: object
                      properties:
                        msg:
                          type: string
                        type:
                          type: string
                  lists:
                    $ref: '#/components/schemas/members'
  /list/{lid}:
    get:
      summary: Get list detail
      tags:
      - lists
      security:
      - basicAuth: []
      parameters:
      - in: path
        name: lid
        schema:
          type: string
          required: false
        description: lid - list id
      responses:
        '200':
          description: list detail
          content:
            application/json:
              schema:
                type: object
                properties:
                  alerts:
                    type: array
                    items:
                      type: object
                      properties:
                        msg:
                          type: string
                        type:
                          type: string
                  list:
                    $ref: '#/components/schemas/group'
  /list/add:
    post:
      summary: Add list
      description: Add a list to the user (from credentials).
      tags:
      - lists
      security:
      - basicAuth: []
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: List name.
      responses:
        '200':
          description: list added, returns list id ('lid')
          content:
            application/json:
              schema:
                type: object
                properties:
                  alerts:
                    type: array
                    items:
                      type: object
                      properties:
                        msg:
                          type: string
                        type:
                          type: string
                  lid:
                    type: string
  /list/{lid}/token/create:
    post:
      summary: Create a list token
      description: The token can be used in the /list/token/{token} request to create a URL under which the list can be publicly displayed.
      tags:
      - lists
      security:
      - basicAuth: []
      parameters:
      - in: path
        name: lid
        schema:
          type: string
          required: false
        description: lid - list id
      responses:
        '200':
          description: Returns the list token.
          content:
            application/json:
              schema:
                type: object
                properties:
                  alerts:
                    type: array
                    items:
                      type: object
                      properties:
                        msg:
                          type: string
                        type:
                          type: string
                  token:
                    type: string
                  alert:
                    type: number
  /list/{lid}/token/delete:
    post:
      summary: Delete list token
      tags:
      - lists
      security:
      - basicAuth: []
      parameters:
      - in: path
        name: lid
        schema:
          type: string
          required: false
        description: lid - list id
      responses:
        '200':
          description: list detail
          content:
            application/json:
              schema:
                type: object
                properties:
                  alerts:
                    type: array
                    items:
                      type: object
                      properties:
                        msg:
                          type: string
                        type:
                          type: string
                  status:
                    type: number
  /list/{lid}/remove:
    post:
      summary: Remove list
      description: Remove list (input list id).
      tags:
      - lists
      security:
      - basicAuth: []
      parameters:
      - in: path
        name: lid
        schema:
          type: string
          required: false
        description: lid - list id
      responses:
        '200':
          description: list detail
          content:
            application/json:
              schema:
                type: object
                properties:
                  alerts:
                    type: array
                    items:
                      type: object
                      properties:
                        msg:
                          type: string
                        type:
                          type: string
  /list/{lid}/members/add:
    post:
      summary: Add objects to list
      tags:
      - lists
      security:
      - basicAuth: []
      parameters:
      - in: path
        name: lid
        schema:
          type: string
          required: false
        description: lid - list id
      requestBody:
        description: 'JSON object containing the pids and titles to add, {"members":[{"pid": "o:1","title": "Title"}]}'
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                members:
                  type: object
                  properties:
                    members:
                      $ref: '#/components/schemas/lists'
      responses:
        '200':
          description: Objects added to list
          content:
            application/json:
              schema:
                type: object
                properties:
                  alerts:
                    type: array
                    items:
                      type: object
                      properties:
                        msg:
                          type: string
                        type:
                          type: string
                  status:
                    type: number
  /list/{lid}/members/remove:
    post:
      summary: Remove objects from list
      tags:
      - lists
      security:
      - basicAuth: []
      parameters:
      - in: path
        name: lid
        schema:
          type: string
          required: false
        description: lid - list id
      requestBody:
        description: JSON object containing an array of objects' pids to remove, {"members":[ "o:1","o:2"]}
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                members:
                  type: object
                  properties:
                    members:
                      type: array
                      items:
                        type: string
                        example: o:1
      responses:
        '200':
          description: Objects removed from list.
          content:
            application/json:
              schema:
                type: object
                properties:
                  alerts:
                    type: array
                    items:
                      type: object
                      properties:
                        msg:
                          type: string
                        type:
                          type: string
                  status:
                    type: number
components:
  schemas:
    members:
      type: array
      items:
        type: object
        properties:
          pid:
            type: string
          pos:
            type: string
      example:
      - pid: o:1
        pos: 1
      - pid: o:2
        pos: 2
    lists:
      type: array
      items:
        type: object
        properties:
          pid:
            type: string
          title:
            type: string
      example:
      - pid: o:1
        title: Title 1
      - pid: o:2
        title: Title 2
    group:
      type: object
      properties:
        owner:
          type: string
        members:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
              username:
                type: string
        created:
          type: number
        name:
          type: string
        updated:
          type: number
        groupid:
          type: string
        _id:
          type: object
          properties:
            $oid:
              type: string
  securitySchemes:
    tokenAuth:
      type: apiKey
      in: header
      name: X-XSRF-TOKEN
    basicAuth:
      type: http
      scheme: basic