Get Action Usage and Limits

Returns per-action usage, limits, and remaining quota for the authenticated user. Enables frontend pre-flight limit checks.

get/billing/usage

Request

Base URL: https://api.aiapplyd.com/api/v1
URL: https://api.aiapplyd.com/api/v1/billing/usage
Auth: HTTP bearer

Response

Action usage data retrieved successfully

successtrue required

Example response

{
  "data": {
    "autoApply": {
      "allowed": true,
      "daily": {
        "limit": 5,
        "remaining": 3,
        "resetAt": "2026-04-01T00:00:00.000Z",
        "used": 2
      },
      "monthly": {
        "limit": 5,
        "remaining": 3,
        "resetAt": "2026-04-01T00:00:00.000Z",
        "used": 2
      },
      "weekly": {
        "limit": 5,
        "remaining": 3,
        "resetAt": "2026-04-01T00:00:00.000Z",
        "used": 2
      }
    },
    "documentQuota": {
      "allowed": true,
      "limit": 5,
      "period": "monthly",
      "remaining": 3,
      "used": 2
    },
    "planTier": "job_seeker",
    "tokensRemaining": 50000
  },
  "meta": {
    "duration": 150,
    "requestId": "req_abc123",
    "timestamp": "2026-10-13T10:27:20.268Z",
    "version": "v1"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.