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

# Mood History

> Get mood entry history for the current user

<Note>This endpoint requires authentication.</Note>

## Query Parameters

<ParamField query="limit" type="integer" default="30">
  Number of entries to return (max 100)
</ParamField>

## Response

Array of mood entries, most recent first.

<ResponseField name="data" type="array">
  <Expandable title="Mood entry object">
    <ResponseField name="id" type="string">
      Entry UUID
    </ResponseField>

    <ResponseField name="value" type="integer">
      Mood value (1-5)
    </ResponseField>

    <ResponseField name="note" type="string">
      Optional note
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      Entry timestamp
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.hitler.app/api/moods?limit=7" \
    -H "Authorization: Bearer YOUR_TOKEN"
  ```

  ```typescript TypeScript theme={null}
  const history = await api.getMoodHistory({ limit: 7 });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "id": "mood-uuid-1",
      "value": 4,
      "note": "Good team meeting today",
      "createdAt": "2024-01-15T09:30:00.000Z"
    },
    {
      "id": "mood-uuid-2",
      "value": 3,
      "note": null,
      "createdAt": "2024-01-14T09:15:00.000Z"
    },
    {
      "id": "mood-uuid-3",
      "value": 4,
      "note": "Finished the big project!",
      "createdAt": "2024-01-13T09:45:00.000Z"
    }
  ]
  ```
</ResponseExample>