# Daily Usage Trend

> Pod Engine API endpoint reference, optimized for LLM consumption.
> Auto-generated from the source-of-truth endpoint registry.
>
> Category: Usage
> Source: https://www.podengine.ai/api-docs/get-team-usage-daily.md
> Interactive HTML docs: https://www.podengine.ai/api-docs/get-team-usage-daily
> Full API reference (all endpoints): https://www.podengine.ai/api-docs/llms.txt

**Base URL:** `http://localhost:4000`
**Auth:** Requires a Bearer token: `Authorization: Bearer YOUR_API_KEY`

---

#### GET /api/v1/teams/usage/daily
**Daily Usage Trend**

Get daily usage breakdown for your team over a time window (7, 30, or 90 days), with limit thresholds for comparison.

```bash
curl -X GET "http://localhost:4000/api/v1/teams/usage/daily" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

**Query schema:**
```json
{
  "type": "object",
  "properties": {
    "window": {
      "default": "30d",
      "type": "string",
      "enum": [
        "7d",
        "30d",
        "90d"
      ],
      "description": "Time window for usage data"
    }
  },
  "required": [
    "window"
  ],
  "additionalProperties": false
}
```

**Response schema:**
```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "OK"
      ]
    },
    "data": {
      "type": "object",
      "properties": {
        "days": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "date": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "description": "Date in YYYY-MM-DD format"
              },
              "totalUsage": {
                "type": "number",
                "minimum": 0,
                "description": "Total requests on this day"
              },
              "usageByAlias": {
                "type": "object",
                "additionalProperties": {
                  "type": "number",
                  "minimum": 0
                },
                "description": "Usage count per alias for this day"
              }
            },
            "required": [
              "date",
              "totalUsage",
              "usageByAlias"
            ],
            "additionalProperties": false
          },
          "description": "Daily usage entries sorted by date ascending"
        },
        "limits": {
          "type": "object",
          "additionalProperties": {
            "nullable": true,
            "type": "number",
            "minimum": 0
          },
          "required": [
            "deepResearchRequests",
            "diarizationRequests",
            "episodeLookups",
            "exportCount",
            "podcastLookups",
            "searchCount",
            "transcriptDownloadCount",
            "transcriptionRequests"
          ],
          "description": "Current monthly limits per alias"
        }
      },
      "required": [
        "days",
        "limits"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "status",
    "data"
  ],
  "additionalProperties": false
}
```

---

## See also

- All endpoints in one file: https://www.podengine.ai/api-docs/llms.txt
- Full reference with every schema inlined: https://www.podengine.ai/api-docs/llms-full.txt
- OpenAPI 3.1 spec: https://www.podengine.ai/api-docs/openapi.json
- Get an API key: https://www.podengine.ai/get-started
- Support: support@podengine.ai
