# Get Usage Limits

`GET /api/users/me/usage-limits`

## Description
Retrieve the authenticated caller's rate limits, usage spending, and storage consumption for the billing period. Accepts an API key or a signed-in session.

## Responses

### 200 — Current rate limits, usage, and storage information.

```json
{
  "type": "object",
  "description": "Current rate limits, usage, and storage information for the authenticated user.",
  "properties": {
    "success": {
      "type": "boolean",
      "description": "Whether the request was successful."
    },
    "rateLimit": {
      "type": "object",
      "description": "Rate limit status for workflow executions.",
      "properties": {
        "sync": {
          "description": "Rate limit bucket for synchronous executions.",
          "allOf": [
            {
              "$ref": "#/components/schemas/RateLimitBucket"
            },
            {
              "type": "object",
              "properties": {
                "isLimited": {
                  "type": "boolean",
                  "description": "Whether the rate limit has been reached."
                }
              }
            }
          ]
        },
        "async": {
          "description": "Rate limit bucket for asynchronous executions.",
          "allOf": [
            {
              "$ref": "#/components/schemas/RateLimitBucket"
            },
            {
              "type": "object",
              "properties": {
                "isLimited": {
                  "type": "boolean",
                  "description": "Whether the rate limit has been reached."
                }
              }
            }
          ]
        },
        "authType": {
          "type": "string",
          "description": "The authentication type used (api or manual)."
        }
      }
    },
    "usage": {
      "type": "object",
      "description": "Current billing period usage.",
      "properties": {
        "currentPeriodCost": {
          "type": "number",
          "description": "Total spend in the current billing period in USD."
        },
        "limit": {
          "type": "number",
          "description": "Maximum allowed spend for the current billing period in USD."
        },
        "plan": {
          "type": "string",
          "description": "Your current subscription plan (e.g., free, pro, team)."
        }
      }
    },
    "storage": {
      "type": "object",
      "description": "File storage usage.",
      "properties": {
        "usedBytes": {
          "type": "integer",
          "description": "Total storage used in bytes."
        },
        "limitBytes": {
          "type": "integer",
          "description": "Maximum storage allowed in bytes."
        },
        "percentUsed": {
          "type": "number",
          "description": "Percentage of storage used (0-100)."
        }
      }
    }
  }
}
```

### 401 — Invalid or missing API key. Ensure the X-API-Key header is set with a valid key.

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "description": "Human-readable error message."
    }
  }
}
```
