---
title: QuotaExpression type | Wartiva GraphQL API
description: Quota represents an nftables expression for enforcing bandwidth or connection quotas. Wartiva GraphQL API reference with arguments, fields, and examples.
url: https://wartiva.com/api-docs/types/quota-expression.html
updated: 2026-10-07
---

Endpoint configuration · GraphQL type

# `QuotaExpression` type

Quota represents an nftables expression for enforcing bandwidth or connection quotas. It allows limiting the total amount of bytes or connections over a period.

## Fields

| Field Name | Description |
|---|---|
| `bytes` - [`Uint64!`](https://wartiva.com/api-docs/types/uint64.html) | The total quota limit in bytes. |
| `consumed` - [`Uint64!`](https://wartiva.com/api-docs/types/uint64.html) | The number of bytes currently consumed against the quota. |
| `over` - [`Boolean!`](https://wartiva.com/api-docs/types/boolean.html) | If true, the quota is checked in "over" mode, meaning the rule matches when the consumed bytes *exceed* the quota. If false, it matches when the consumed bytes are *below* the quota. |

## Used by

- [`ChainExpression`](https://wartiva.com/api-docs/types/chain-expression.html) union: A union of all possible nftables chain expression types.

## Example

### Example

```json
{
  "bytes": "8589934592",
  "consumed": "8589934592",
  "over": true
}

```

---

Wartiva is in early access. Request access: https://wartiva.com/early-access.html  
All pages: https://wartiva.com/llms.txt