> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

# org_usage

> Retrieve organization-wide usage, PayGo USD cost, and request counts across all API keys. Enterprise-only; authenticate with the org owner's personal API key.

<div className="tool-route"><span className="tool-row-method" data-method="POST">POST</span><code>{"https://api.tavily.com/org-usage"}</code></div>

```python tavily_org_usage.py theme={null}
from charter.packs import tavily

result = await tavily.org_usage.ainvoke({"organizationName": ...})
```

## Body

<div className="reference-table">
  | Field                                                                    | Type                                                               | Description                                                                                                         |
  | ------------------------------------------------------------------------ | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------- |
  | `organizationName` <span className="required" title="required">\*</span> | `string`                                                           | Exact case-sensitive organization name.                                                                             |
  | `startDate`                                                              | `string`                                                           | Inclusive start date (`YYYY-MM-DD`). The server applies the start of the current billing cycle when this is absent. |
  | `endDate`                                                                | `string`                                                           | Inclusive end date (`YYYY-MM-DD`). The server applies today when this is absent.                                    |
  | `projectId`                                                              | `string`                                                           | Scope results to a single project.                                                                                  |
  | `depth`                                                                  | [OrgUsageDepth](/charter/charter/packs/tavily/usage/objects#orgusagedepth) | Scope results to a single request depth.                                                                            |
</div>