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

# Stats

> Get memory system statistics for your namespace.

<Note>
  Stats calls do **not** count against your monthly ops limit.
</Note>

### Authorizations

<ParamField header="X-API-Key" type="string" required>
  Your Atlas API key. Format: `atlas_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`.
</ParamField>

***

### Body

<ParamField body="user_id" type="string" required>
  Namespace to query. Overridden server-side from your API key.
</ParamField>

<ParamField body="persona" type="string" default="shared">
  Memory persona to report stats for.
</ParamField>

***

### Response

<ResponseField name="episodic_count" type="integer">
  Total vector chunks stored in Qdrant for this namespace.
</ResponseField>

<ResponseField name="semantic_entities" type="integer">
  Unique entity nodes in the Neo4j knowledge graph.
</ResponseField>

<ResponseField name="semantic_relations" type="integer">
  Relationship edges in the Neo4j knowledge graph.
</ResponseField>

<ResponseField name="models_loaded" type="boolean">
  Whether Qwen 0.5B and MiniLM are loaded and ready.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url https://api.bsyncs.com/brain/stats \
    --header 'X-API-Key: atlas_your_key_here' \
    --header 'Content-Type: application/json' \
    --data '{
      "user_id": "user-123"
    }'
  ```

  ```python Python SDK theme={null}
  from atlas_memory import CognitiveBrain

  brain = CognitiveBrain(api_key="atlas_your_key_here", user_id="user-123")

  stats = brain.stats()
  print(
      f"Memory: {stats['semantic_entities']} entities, "
      f"{stats['semantic_relations']} relations, "
      f"{stats['episodic_count']} chunks"
  )
  ```

  ```javascript Node.js theme={null}
  const response = await fetch("https://api.bsyncs.com/brain/stats", {
    method: "POST",
    headers: {
      "X-API-Key": "atlas_your_key_here",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ user_id: "user-123" }),
  });
  const stats = await response.json();
  console.log(`${stats.semantic_entities} entities in graph`);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "episodic_count": 142,
    "semantic_entities": 87,
    "semantic_relations": 203,
    "models_loaded": true
  }
  ```

  ```json 401 theme={null}
  {
    "detail": "Invalid or inactive API key"
  }
  ```
</ResponseExample>