Nirvana Analytics API

The Analytics API from Nirvana — 1 operation(s) for analytics.

GitHub OpenAPI

Operations 1

GET /v1/analytics GTD system health analytics #

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/nirvanahq-com:nirvanahq-com-analytics-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

nirvanahq-com-analytics-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Nirvana Task Analytics API
  version: 1.0.0-beta
  description: 'Nirvana Task API (Public Beta). Clean REST endpoints for integrations, automation, and AI agents (MCP servers, scripts, webhooks). Auth: `Bearer `. Legacy v0 endpoints are removed from this service; migrate integrations to /v1/* endpoints. During beta, backward compatibility is best-effort and minor response changes may occur before GA.'
servers:
- url: https://api.nirvanahq.com
security:
- bearerAuth: []
tags:
- name: Analytics
paths:
  /v1/analytics:
    get:
      operationId: v1GetAnalytics
      summary: GTD system health analytics
      description: Returns a comprehensive GTD system health snapshot computed server-side over the user's full task graph. Covers velocity (tasks captured/completed in 7d/30d), dormancy (tasks untouched 30/60/90 days), inbox age, due date pressure, waiting-for aging, someday graveyard, project health, tag usage, and effort distribution. Suitable for weekly reviews, coaching insights, or identifying stalled tasks.
      tags:
      - Analytics
      responses:
        '200':
          description: Analytics snapshot
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                  analytics:
                    type: object
              example:
                ok: true
                analytics:
                  snapshot_ts: 1743278400
                  velocity:
                    captured_7d: 12
                    captured_30d: 48
                    completed_7d: 9
                    completed_30d: 35
                    logbook_total: 892
                    capture_to_completion_ratio_30d: 1.37
                    avg_throughput_days: 4.2
                  dormancy:
                    dormant_30d: 14
                    dormant_60d: 8
                    dormant_90d: 3
                    inbox_count: 2
                    inbox_avg_age_days: 1
                    inbox_older_than_2d: 0
                    inbox_older_than_7d: 0
                  due_dates:
                    overdue: 1
                    due_7d: 3
                    due_14d: 2
                    due_30d: 5
                  waiting:
                    total: 4
                    avg_age_days: 6
                    older_than_7d: 1
                    older_than_14d: 0
                  scheduled_horizon:
                    arriving_7d: 2
                    arriving_14d: 1
                  someday:
                    total: 18
                    older_than_90d: 7
                    older_than_180d: 3
                    older_than_365d: 1
                  projects:
                    active: 5
                    stalled: 1
                    engaged_pct: 80
                    avg_tasks_per_project: 3.4
                  tags:
                    unique_count: 12
                    top:
                    - tag: work
                      count: 22
                    next_tasks_with_context_pct: 68
                  effort:
                    next_with_etime_pct: 45
                    etime_distribution:
                      short: 8
                      medium: 12
                      long: 3
                    next_with_energy_pct: 30
                    energy_distribution:
                      '1': 4
                      '2': 6
                      '3': 2
                  pressure:
                    actionable_total: 47
                    weeks_of_backlog: 5.5
                  system:
                    total_items: 1284
                    tasks: 363
                    projects: 5
                    reflists: 2
                    refitems: 14
                    logbook: 892
                    trash: 8
                    oldest_item_year: 2018
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  responses:
    Unauthorized:
      description: Missing or invalid Bearer token
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
          example:
            error: Unauthorized
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer