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

# Get current user

> Identity + remaining budgets + credit balance + subscription state in one call

The canonical "what can I do right now" endpoint. Verifies your API key AND surfaces every budget the UI needs to render paywall hints.

## Request

```bash theme={null}
curl https://www.catchthegoodones.com/api/v2/me \
  -H "Authorization: Bearer ctgo_your_api_key_here"
```

## Response

```json theme={null}
{
  "name": "Jane Smith",
  "email": "jane@example.com",
  "subscriptionStatus": "active",
  "isFreeTier": false,
  "accounts": [
    {
      "accountId": 7,
      "xHandle": "yongfook",
      "tier": "starter",
      "monthlyRetest": {
        "used": 1,
        "budget": 12,
        "remaining": 11,
        "billingPeriodStart": "2026-05-15T00:00:00Z"
      },
      "dailySync": { "used": 0, "cap": 1, "remaining": 1 }
    }
  ],
  "credits": {
    "balance": 47,
    "lowBalanceThreshold": 10,
    "isLow": false,
    "autoTopupEnabled": false
  },
  "totals": {
    "monthlyRetestRemaining": 11,
    "dailySyncRemaining": 1
  }
}
```

## Response fields

| Field                      | Type    | Description                                          |
| -------------------------- | ------- | ---------------------------------------------------- |
| `name`                     | string  | User's display name                                  |
| `email`                    | string  | User's email                                         |
| `subscriptionStatus`       | enum    | `active`, `trialing`, `free_user`, `past_due`, etc.  |
| `isFreeTier`               | boolean | Convenience flag                                     |
| `accounts[]`               | array   | Per-account budgets                                  |
| `accounts[].monthlyRetest` | object  | Re-test budget for this account, this billing period |
| `accounts[].dailySync`     | object  | Daily sync slot count for this account               |
| `credits`                  | object  | Team credit balance for enrichment                   |
| `totals`                   | object  | Sum-across-accounts rollup                           |

## Auth

Bearer API key or session cookie.