# Current Month Usage

> 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-current.md
> Interactive HTML docs: https://www.podengine.ai/api-docs/get-team-usage-current
> 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/current
**Current Month Usage**

Get your team's current month API usage and limits for each usage category, along with enabled feature flags and plan information.

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

**Response schema:**
```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "OK"
      ]
    },
    "data": {
      "type": "object",
      "properties": {
        "month": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}$",
          "description": "Current month in YYYY-MM format"
        },
        "plan": {
          "type": "string",
          "description": "Current team plan tier"
        },
        "featureFlags": {
          "type": "object",
          "properties": {
            "s3Integration": {
              "type": "boolean"
            },
            "airtableIntegration": {
              "type": "boolean"
            },
            "automatedSearch": {
              "type": "boolean"
            },
            "applyPage": {
              "type": "boolean"
            },
            "goHighLevelIntegration": {
              "type": "boolean"
            }
          },
          "additionalProperties": false,
          "description": "Enabled feature flags for the team"
        },
        "aliases": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "alias": {
                "type": "string",
                "enum": [
                  "deepResearchRequests",
                  "diarizationRequests",
                  "episodeLookups",
                  "exportCount",
                  "podcastLookups",
                  "searchCount",
                  "transcriptDownloadCount",
                  "transcriptionRequests"
                ],
                "description": "The usage category identifier"
              },
              "label": {
                "type": "string",
                "description": "Human-readable label for this usage category"
              },
              "used": {
                "type": "number",
                "minimum": 0,
                "description": "Number of requests used this month"
              },
              "limit": {
                "nullable": true,
                "description": "Monthly limit (null = unlimited, 0 = disabled)",
                "type": "number",
                "minimum": 0
              }
            },
            "required": [
              "alias",
              "label",
              "used",
              "limit"
            ],
            "additionalProperties": false
          },
          "description": "Usage breakdown per category"
        },
        "totalUsed": {
          "type": "number",
          "description": "Total requests used across all categories this month"
        },
        "projectUsage": {
          "description": "Monthly active project and guest profile usage",
          "type": "object",
          "properties": {
            "projects": {
              "type": "object",
              "properties": {
                "used": {
                  "type": "number"
                },
                "limit": {
                  "nullable": true,
                  "type": "number"
                }
              },
              "required": [
                "used",
                "limit"
              ],
              "additionalProperties": false
            },
            "guestProfiles": {
              "type": "object",
              "properties": {
                "used": {
                  "type": "number"
                },
                "limit": {
                  "nullable": true,
                  "type": "number"
                }
              },
              "required": [
                "used",
                "limit"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "projects",
            "guestProfiles"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "month",
        "plan",
        "featureFlags",
        "aliases",
        "totalUsed"
      ],
      "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