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

# Get Episode Count

> Retrieve the episode count for a project.

An *episode* is the minimal unit of memory stored in the MemMachine system.
In most cases, a single episode corresponds to one message or interaction
from a user. Episodes are appended as the project accumulates conversational
or operational data.

This endpoint returns the total number of episodes currently recorded for
the specified project. If the project does not exist, a not-found error is
returned.




## OpenAPI

````yaml /platform.openapi.json post /v2/projects/episode_count/get
openapi: 3.0.4
info:
  description: >-
    Public REST API for the MemMachine memory system. Manages projects and
    memories.
  title: MemMachine Public API
  version: 0.1.0
servers:
  - url: https://api.memmachine.ai
security:
  - BearerAuth: []
tags:
  - name: Projects
  - name: Memories
  - name: Metrics
  - name: Health
paths:
  /v2/projects/episode_count/get:
    post:
      tags:
        - Projects
      summary: Get Episode Count
      description: >
        Retrieve the episode count for a project.


        An *episode* is the minimal unit of memory stored in the MemMachine
        system.

        In most cases, a single episode corresponds to one message or
        interaction

        from a user. Episodes are appended as the project accumulates
        conversational

        or operational data.


        This endpoint returns the total number of episodes currently recorded
        for

        the specified project. If the project does not exist, a not-found error
        is

        returned.
      operationId: GetEpisodeCount
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetProjectSpec'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EpisodeCountResponse'
          description: Successful Response
        default:
          $ref: '#/components/responses/UnexpectedError'
components:
  schemas:
    GetProjectSpec:
      allOf:
        - $ref: '#/components/schemas/ProjectScope'
      description: |
        Specification model for retrieving a project.

        The `project_id` uniquely identifies the project to retrieve.
      title: GetProjectSpec
    EpisodeCountResponse:
      description: >
        Response model representing the number of episodes associated with a
        project.


        This model is typically returned by analytics or monitoring endpoints

        that track usage activity (e.g., number of computation episodes,
        workflow

        runs, or operational cycles).


        The count reflects the current recorded total at the time of the
        request.
      properties:
        count:
          description: The total number of episodic memories in the project.
          minimum: 0
          title: Count
          type: integer
      required:
        - count
      title: EpisodeCountResponse
      type: object
    ProjectScope:
      properties:
        project_id:
          default: ''
          description: >-
            The identifier of the project. If empty, the user's default project
            is used.
          maxLength: 255
          pattern: ^[\p{L}\p{N}_:-]*$
          title: Project Id
          type: string
          x-go-type-skip-optional-pointer: true
      type: object
    Error:
      properties:
        code:
          description: Error code.
          format: int32
          type: integer
        message:
          description: Error message.
          type: string
      required:
        - code
        - message
      type: object
  responses:
    UnexpectedError:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Unexpected error.
  securitySchemes:
    BearerAuth:
      scheme: bearer
      type: http

````