# usage > Report the calling organization's plan, the free quota it has left this period and the day the quota renews, its balance, the credits its agents'… Report the calling organization's plan, the free quota it has left this period and the day the quota renews, its balance, the credits its agents' tasks hold and what is left available to spend, the coverage it has left for the current period, the per-call limits in force, how many projects it holds revealed and how many profile parts it currently holds. Free. Consult it before planning a wide search: coverage limits how many new entities you can see in a period; the free quota and the available credits (the balance less what agents' tasks hold) limit what you can pay for. What the tools accept and charge for is in capabilities. ## Request ```text POST https://api.megido.io/v1/tools/usage ``` Headers: `Authorization: Bearer `, and with a body `Content-Type: application/json`. The tool's arguments; {} or no body for none. Its JSON Schema: ```json { "type": "object", "properties": {}, "additionalProperties": false } ``` ## Answers | Status | Answer | |---|---| | 200 | The tool's answer: `UsageAnswer` | | 400 | The request cannot be served as sent: `bad_request`, `invalid_params` | | 401 | No key, or a key the API does not take: `unauthorised` | | 413 | The body is larger than the API takes: `bad_request` | | 415 | The body is not sent as application/json: `bad_request` | | 429 | Too many calls: `rate_limited` | | 500 | The call failed on Megido's side: `internal_error` | | 503 | Not available just now: `service_unavailable`, `lock_timeout` | Every error has the body `{"error": {"code": "…", "message": "…"}}` with the details of its code. The OpenAPI document holds every schema: https://api.megido.io/v1/openapi.json.