Kavita Activity API

The Activity API from Kavita — 1 operation(s) for activity.

GitHub OpenAPI

Operations 1

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/Activity/current List active reading sessions · Returns active reading sessions on the Server #
Ask an LLM
“Which books are currently being read on the server?”
“How many active reading sessions are there right now?”
Tell an agent
Show the active reading sessions on the server.
List everyone currently reading a book.

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/kavita:kavita-activity-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

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

OpenAPI Specification

kavita-activity-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Kavita Activity API
  description: Kavita provides a set of APIs authenticated via an Auth Key passed in the `x-api-key` header. Generate an Auth Key under User Settings → Manage Auth Keys, paste it into the Authorize panel, and all Try It requests will include it. Assume all fields of a payload are required unless marked optional. Built against v0.9.1.15
  license:
    name: GPL-3.0
    url: https://github.com/Kareadita/Kavita/blob/develop/LICENSE
  version: 0.9.1.15
servers:
- url: '{protocol}://{hostpath}'
  variables:
    protocol:
      default: http
      enum:
      - http
      - https
    hostpath:
      default: localhost:5000
security:
- AuthKey: []
tags:
- name: Activity
paths:
  /api/Activity/current:
    get:
      tags:
      - Activity
      summary: Returns active reading sessions on the Server
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ReadingSessionDto'
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ReadingSessionDto'
            text/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ReadingSessionDto'
      operationId: getApiActivityCurrent
      x-operation-id-source: derived
components:
  schemas:
    AuthenticationType:
      enum:
      - 0
      - 1
      - 2
      - 3
      type: integer
      description: 'Members:

        - `0` — Unknown

        - `1` — JWT

        - `2` — AuthKey

        - `3` — OIDC'
      format: int32
      x-enum-varnames:
      - Unknown
      - JWT
      - AuthKey
      - OIDC
      x-enum-descriptions:
      - Unknown
      - JWT
      - AuthKey
      - OIDC
    ClientDevicePlatform:
      enum:
      - 0
      - 1
      - 2
      - 3
      - 4
      - 5
      type: integer
      description: 'Members:

        - `0` — Unknown

        - `1` — Windows

        - `2` — macOS (MacOs)

        - `3` — IOs (Ios)

        - `4` — Linux

        - `5` — Android'
      format: int32
      x-enum-varnames:
      - Unknown
      - Windows
      - MacOs
      - Ios
      - Linux
      - Android
      x-enum-descriptions:
      - Unknown
      - Windows
      - macOS
      - IOs
      - Linux
      - Android
    ClientInfoDto:
      type: object
      properties:
        userAgent:
          type:
          - string
          - 'null'
        ipAddress:
          type:
          - string
          - 'null'
        authType:
          $ref: '#/components/schemas/AuthenticationType'
        clientType:
          $ref: '#/components/schemas/ClientDeviceType'
        appVersion:
          type:
          - string
          - 'null'
        browser:
          type:
          - string
          - 'null'
        browserVersion:
          type:
          - string
          - 'null'
        platform:
          $ref: '#/components/schemas/ClientDevicePlatform'
        deviceType:
          type:
          - string
          - 'null'
        screenWidth:
          type:
          - integer
          - 'null'
          format: int32
        screenHeight:
          type:
          - integer
          - 'null'
          format: int32
        orientation:
          type:
          - string
          - 'null'
      additionalProperties: false
    ClientDeviceType:
      enum:
      - 0
      - 1
      - 2
      - 3
      - 4
      - 5
      - 6
      type: integer
      description: 'Members:

        - `0` — Unknown

        - `1` — Web Browser (WebBrowser)

        - `2` — Web App (WebApp)

        - `3` — KOReader (KoReader)

        - `4` — Panels

        - `5` — Librera

        - `6` — OPDS Client (OpdsClient)'
      format: int32
      x-enum-varnames:
      - Unknown
      - WebBrowser
      - WebApp
      - KoReader
      - Panels
      - Librera
      - OpdsClient
      x-enum-descriptions:
      - Unknown
      - Web Browser
      - Web App
      - KOReader
      - Panels
      - Librera
      - OPDS Client
    ReadingSessionDto:
      type: object
      properties:
        id:
          type: integer
          format: int32
        startTimeUtc:
          type: string
          format: date-time
        endTimeUtc:
          type:
          - string
          - 'null'
          format: date-time
        isActive:
          type: boolean
        activityData:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/ReadingActivityDataDto'
        userId:
          type: integer
          format: int32
        username:
          type:
          - string
          - 'null'
      additionalProperties: false
    ReadingActivityDataDto:
      type: object
      properties:
        chapterId:
          type: integer
          format: int32
        volumeId:
          type: integer
          format: int32
        seriesId:
          type: integer
          format: int32
        libraryId:
          type: integer
          format: int32
        startPage:
          type: integer
          format: int32
        endPage:
          type: integer
          format: int32
        startTimeUtc:
          type: string
          format: date-time
        endTimeUtc:
          type:
          - string
          - 'null'
          format: date-time
        pagesRead:
          type: integer
          format: int32
        wordsRead:
          type: integer
          format: int32
        totalPages:
          type: integer
          format: int32
        totalWords:
          type: integer
          format: int32
        libraryName:
          type:
          - string
          - 'null'
        seriesName:
          type:
          - string
          - 'null'
        chapterTitle:
          type:
          - string
          - 'null'
        clientInfo:
          $ref: '#/components/schemas/ClientInfoDto'
      additionalProperties: false
  securitySchemes:
    AuthKey:
      type: apiKey
      description: Auth Key authentication. Enter your Auth key from your user settings
      name: x-api-key
      in: header