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

# Check usage and limits

> Track plan state, usage, credits, feature gates, and limits.

Check usage and limits before running repeated or long-running work.

## Steps

1. Inspect the project subscription.
2. Check current usage and limits.
3. Review available credits.
4. Check feature gates before using gated capabilities.
5. Recheck limits after scheduled jobs, long agent runs, or deployments.

## Try it with REST

Get current usage:

`GET /account/usage`

```bash title="Terminal" theme={null}
curl https://api.veryfront.com/account/usage \
  -H "Authorization: Bearer $VERYFRONT_API_KEY"
```

Check usage limits:

`GET /account/usage/limits`

```bash title="Terminal" theme={null}
curl https://api.veryfront.com/account/usage/limits \
  -H "Authorization: Bearer $VERYFRONT_API_KEY"
```

## API surfaces

| Surface | Start here                                                                                                                                                                              |
| ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| REST    | [Usage](/cloud/rest/api-reference/usage/get-project-usage), [Credits](/cloud/rest/api-reference/credits/get-credit-balance), [Gates](/cloud/rest/api-reference/gates/check-gate-access) |
| GraphQL | [Usage Overview](/cloud/graphql/operations/usage/queries/usageoverview), [Usage Summary](/cloud/graphql/operations/usage-limits/queries/usagesummary)                                   |
| MCP     | [Get Usage](/cloud/mcp/tools/get-usage), [Get Usage Limits](/cloud/mcp/tools/get-usage-limits)                                                                                          |

## Verify

Confirm the remaining capacity covers the work you plan to run.

Check warnings before starting repeated jobs or long-running agents.

## Usage surfaces

| Surface      | Use it for                         |
| ------------ | ---------------------------------- |
| Subscription | Plan and billing state.            |
| Usage        | Metered project consumption.       |
| Credits      | Included or prepaid capacity.      |
| Gates        | Feature availability.              |
| Limits       | Warnings or blocks before overuse. |

## API reference

| API                       | Use                                             |
| ------------------------- | ----------------------------------------------- |
| [REST](/cloud/rest)       | Subscription, usage, credits, gates, and cache. |
| [GraphQL](/cloud/graphql) | Usage, limit, and subscription views.           |
| [MCP](/cloud/mcp)         | Usage, subscription, resource, and gate tools.  |
