> ## 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.

# UsageOverview

> Response type in the GraphQL API.

Usage overview for the current billing period. Used for quota visibility, billing, and runtime health checks.

| Field | Type | Description |
| - | - | - |
| `resourceType` | [`String!`](/docs/cloud/graphql/types/string) | Bucket with the highest percentage used; ties retain the earlier bucket. Current values: storage, bandwidth, api\_calls, custom\_domains, code\_exports, veryfront\_badge |
| `usage` | [`Float!`](/docs/cloud/graphql/types/float) | Current usage amount for the primary usage bucket |
| `limit` | [`Float!`](/docs/cloud/graphql/types/float) | Maximum allowed usage for the primary bucket; -1 means unlimited |
| `percentage` | [`Float!`](/docs/cloud/graphql/types/float) | Percentage of quota used; can exceed 100 and is zero for unlimited quota |
| `isNearLimit` | [`Boolean!`](/docs/cloud/graphql/types/boolean) | Whether usage is at least 80% of a finite quota |
| `isOverLimit` | [`Boolean!`](/docs/cloud/graphql/types/boolean) | Whether usage is at least 100% of a finite quota |
| `storage` | [`UsageMetric`](/docs/cloud/graphql/types/usagemetric) | Storage usage and limit information |
| `bandwidth` | [`UsageMetric`](/docs/cloud/graphql/types/usagemetric) | Bandwidth usage and limit information |
| `apiCalls` | [`UsageMetric`](/docs/cloud/graphql/types/usagemetric) | API calls usage and limit information |
| `customDomains` | [`UsageMetric`](/docs/cloud/graphql/types/usagemetric) | Custom domains usage and limit information |
| `codeExports` | [`UsageMetric`](/docs/cloud/graphql/types/usagemetric) | Code export usage and limit information |
| `veryfrontBadge` | [`UsageMetric`](/docs/cloud/graphql/types/usagemetric) | Veryfront badge usage and limit information |
| `aiCredits` | [`UsageMetric`](/docs/cloud/graphql/types/usagemetric) | Deprecated: use credits system instead. Always returns null. Deprecated: Use credits system (GET /credits/balance) instead |
| `periodStart` | [`String`](/docs/cloud/graphql/types/string) | Start of the current billing period |
| `periodEnd` | [`String`](/docs/cloud/graphql/types/string) | End of the current billing period |

[All GraphQL types](/docs/cloud/graphql/schema) · [Operations](/docs/cloud/graphql)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.