> ## Documentation Index
> Fetch the complete documentation index at: https://nemonist.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get goal insights

> The goals' burn up, as GitHub Projects' built-in Burn up chart: for each UTC day of the period, how many goals were open and how many closed at that day's end (today: up to now), and today's counts grouped by state, role and progress. Computed on read from each goal's opened time, its close and its kept earlier closes (a reopened goal counts open again from when it was reopened); nothing is stored. q is the Goals filter (as GET /issues), applied to the goals as they are today. A goal with no opened time is counted in total and undated but never drawn; complete is false when a goal dropped its oldest closes (80 are kept), so days before its oldest kept close may miscount it.



## OpenAPI

````yaml /openapi.json get /folders/{id}/stats/issues
openapi: 3.1.0
info:
  title: Nemonist API
  version: 1.0.0
  description: >-
    OpenRouter-compatible API with durable per-workspace memory. Point any
    OpenRouter client at https://nemonist.com/api/v1 with a Nemonist key
    (sk-nm-...). Chat completions, Responses and Messages requests from a
    workspace carrying a .nemonist/key get its memory; every other request is
    answered as OpenRouter would.
  contact:
    name: Nemonist
    url: https://nemonist.com
servers:
  - url: https://nemonist.com/api/v1
    description: Production
security:
  - apiKey: []
tags:
  - description: API key management endpoints
    name: API Keys
  - description: Analytics and usage endpoints
    name: Analytics
  - description: Anthropic Messages endpoints
    name: Anthropic Messages
  - description: BYOK endpoints
    name: BYOK
  - description: Benchmarks endpoints
    name: Benchmarks
  - description: Chat completion endpoints
    name: Chat
  - description: Credit management endpoints
    name: Credits
  - description: >-
      Public OpenRouter usage datasets. Data returned by these endpoints is
      licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/):
      reuse and republish it, including commercially, with attribution to
      OpenRouter.
    name: Datasets
  - description: Text embedding endpoints
    name: Embeddings
  - description: Endpoint information
    name: Endpoints
  - name: Folders
    description: >-
      Your memory folders, over your account's API key: read, export, upload,
      and manage keys.
  - description: Generation history endpoints
    name: Generations
  - description: Guardrails endpoints
    name: Guardrails
  - description: Images endpoints
    name: Images
  - name: Memory
    description: Nemonist's per-workspace memory.
  - name: Model runs
    description: Run models (physics and others) on inputs; one contract for every model
  - description: Model information endpoints
    name: Models
  - description: OAuth authentication endpoints
    name: OAuth
  - description: Organization endpoints
    name: Organization
  - description: Private Endpoints endpoints
    name: Private Endpoints
  - description: Provider information endpoints
    name: Providers
  - description: Rerank endpoints
    name: Rerank
  - description: OpenAI-compatible Responses API endpoints
    name: Responses
  - description: Speech-to-text endpoints
    name: STT
    x-displayName: Transcriptions
  - description: >-
      System One endpoints for models such as Jev, compatible with the TypeSafe
      SDKs. See https://openrouter.ai/docs/guides/community/typesafe-sdk.
    name: SystemOne
    x-displayName: System One
  - description: Text-to-speech endpoints
    name: TTS
    x-displayName: Speech
  - description: Video Generation endpoints
    name: Video Generation
  - description: Workspaces endpoints
    name: Workspaces
  - name: beta.responses
    description: >-
      Deprecated alias of responses. Use responses instead; scheduled for
      removal (sunset date TBD).
paths:
  /folders/{id}/stats/issues:
    get:
      tags:
        - Folders
      summary: Get goal insights
      description: >-
        The goals' burn up, as GitHub Projects' built-in Burn up chart: for each
        UTC day of the period, how many goals were open and how many closed at
        that day's end (today: up to now), and today's counts grouped by state,
        role and progress. Computed on read from each goal's opened time, its
        close and its kept earlier closes (a reopened goal counts open again
        from when it was reopened); nothing is stored. q is the Goals filter (as
        GET /issues), applied to the goals as they are today. A goal with no
        opened time is counted in total and undated but never drawn; complete is
        false when a goal dropped its oldest closes (80 are kept), so days
        before its oldest kept close may miscount it.
      operationId: getFolderGoalInsights
      parameters:
        - name: id
          in: path
          required: true
          description: The folder's id (fld_...), as GET /folders lists it.
          schema:
            type: string
        - name: q
          in: query
          schema:
            type: string
          description: The Goals filter, as GET /issues.
        - name: period
          in: query
          schema:
            type: string
            enum:
              - 2W
              - 1M
              - 3M
              - max
            default: 2W
          description: How many days back.
      responses:
        '200':
          description: The burn up.
          content:
            application/json:
              schema:
                type: object
                description: Days, two series and today's groups.
                properties:
                  period:
                    type: string
                    description: >-
                      2W, 1M, 3M or max (max: from the oldest goal's day, at
                      most 3660 days).
                  q:
                    type: string
                    description: The filter, when one was given.
                  days:
                    type: array
                    description: Each UTC day of the period, oldest first.
                    items:
                      type: string
                      description: YYYY-MM-DD.
                  series:
                    type: array
                    description: 'Open, then Closed: one count per day.'
                    items:
                      type: object
                      description: One series.
                      properties:
                        name:
                          type: string
                          description: Open or Closed.
                        data:
                          type: array
                          description: One count per day, as days.
                          items:
                            type: integer
                            description: Goals.
                      required:
                        - name
                        - data
                  groups:
                    type: object
                    description: Today's counts.
                    properties:
                      state:
                        type: object
                        additionalProperties:
                          type: integer
                        description: open, done, withdrawn, duplicate.
                      role:
                        type: object
                        additionalProperties:
                          type: integer
                        description: developer, reviewer, customer, none.
                      progress:
                        type: object
                        additionalProperties:
                          type: integer
                        description: closer, same, further, blocked, done, none.
                    required:
                      - state
                      - role
                      - progress
                  total:
                    type: integer
                    description: Goals the filter matched.
                  undated:
                    type: integer
                    description: Of those, goals with no opened time (not drawn).
                  complete:
                    type: boolean
                    description: false when a goal dropped its oldest closes.
                required:
                  - period
                  - days
                  - series
                  - groups
                  - total
                  - undated
                  - complete
        '400':
          description: >-
            A period other than 2W, 1M, 3M or max (BAD_PERIOD), or a filter term
            the Goals filter does not know (BAD_QUERY), named.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NemonistError'
        '401':
          description: Missing or invalid key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NemonistError'
        '404':
          description: No such folder under your account, or it is another member's.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NemonistError'
        '500':
          description: 'Nemonist: an internal error answered this request; retry.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NemonistError'
        '503':
          description: 'Nemonist: the account service is temporarily unavailable; retry.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NemonistError'
components:
  schemas:
    NemonistError:
      type: object
      description: An error answer.
      required:
        - error
      properties:
        error:
          type: object
          description: What went wrong.
          required:
            - message
          properties:
            code:
              type:
                - integer
                - string
              description: HTTP status or a short error code.
            type:
              type: string
              description: Error kind, such as proxy_error.
            message:
              type: string
              description: Human-readable error message.
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: >-
        A Nemonist key (sk-nm-...) as a bearer token in the Authorization
        header.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.