---
title: "FREE — remaining allowance for an API key (never metered)"
method: GET
path: "/v1/balance"
tags: ["Keys"]
---

# FREE — remaining allowance for an API key (never metered)

`GET /v1/balance`

## Request

- Base URL: `https://mearef.dev`
- URL: `https://mearef.dev/v1/balance`
- Auth: API key in header `X-API-Key`

## Response `200`

plan, unit, quota, used, remaining, period, resets_on, covers

## Other responses

- `400`: No X-API-Key header
- `401`: Unknown or inactive key

---

[API](https://skmtc.dev/mearef/apis/mearef-middle-eastern-government-reference-data.md) · [All operations](https://skmtc.dev/mearef/apis/mearef-middle-eastern-government-reference-data/llms.txt) · [OpenAPI document](https://skmtc.dev/mearef/apis/mearef-middle-eastern-government-reference-data/revisions/7b64e3502210?raw)