> For the complete documentation index, see [llms.txt](https://eventx-hq.gitbook.io/knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://eventx-hq.gitbook.io/knowledge-base/api-v2/api-quota.md).

# Api Quota

Organization API quota — how many calls are allowed, used and remaining this period

## Get the remaining API quota

> Returns the caller's organization API quota for the current period: how many calls are allowed, how many are used, and how many remain. The quota is counted per organization (every event shares one budget) and resets at the start of the next UTC month. Calling this endpoint does not consume quota. The same numbers are returned on every response as the X-API-Quota-Limit, X-API-Quota-Remaining and X-API-Quota-Reset headers.

```json
{"openapi":"3.2.1","info":{"title":"EventX Public API v2","version":"v2"},"tags":[{"name":"api quota","description":"Organization API quota — how many calls are allowed, used and remaining this period"}],"servers":[{"url":"https://api.eventx.io","description":"EventX Public API server"}],"security":[{"organizerApiToken":[]}],"components":{"securitySchemes":{"organizerApiToken":{"type":"http","scheme":"bearer","description":"Organizer API token — Authorization: Bearer evtx_live_… (Org/Event scoped, read/write)."}}},"paths":{"/v2/api-quota":{"get":{"tags":["api quota"],"summary":"Get the remaining API quota","description":"Returns the caller's organization API quota for the current period: how many calls are allowed, how many are used, and how many remain. The quota is counted per organization (every event shares one budget) and resets at the start of the next UTC month. Calling this endpoint does not consume quota. The same numbers are returned on every response as the X-API-Quota-Limit, X-API-Quota-Remaining and X-API-Quota-Reset headers.","responses":{"200":{"description":"Current quota usage","content":{"application/json":{"schema":{"type":"object","properties":{"quota":{"type":"number","description":"Calls allowed for the current period (subscription.api_monthly_quota, default 100)."},"used":{"type":"number","description":"Calls already counted for the current period."},"remaining":{"type":"number","description":"Calls still available for the current period."},"period":{"type":"string","description":"Quota period (YYYY-MM, UTC)."},"resetsAt":{"type":"string","description":"When the quota period rolls over and the counter resets."},"scope":{"type":"string","description":"Quota is counted per organization — every event of the organization shares one budget."}},"required":["quota","used","remaining","period","resetsAt","scope"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status":{"type":"number"},"meta":{}},"required":["code","message","status"]}}}},"500":{"description":"Could not read the organization quota","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"status":{"type":"number"},"meta":{}},"required":["code","message","status"]}}}}}}}}}
```
