> ## 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.

# logs

> Retrieve per-request usage logs for API keys under your account. Requires a paid plan or pay-as-you-go. Logs never include request input or output.

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

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

result = await tavily.logs.ainvoke({})
```

## Body

<div className="reference-table">
  | Field            | Type                                                              | Description                                                                                                                                   |
  | ---------------- | ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
  | `limit`          | `integer`                                                         | Maximum logs to return, most recent first. The server applies 10 when this is absent. <span className="field-constraints">≥ 1; ≤ 10000</span> |
  | `startDate`      | `string`                                                          | Inclusive start date (`YYYY-MM-DD`).                                                                                                          |
  | `endDate`        | `string`                                                          | Inclusive end date (`YYYY-MM-DD`).                                                                                                            |
  | `endpoints`      | [LogEndpoint](/charter/charter/packs/tavily/usage/objects#logendpoint)\[] | Filter by endpoint. The server returns all endpoints when this is absent.                                                                     |
  | `projectId`      | `string`                                                          | Filter to a single project.                                                                                                                   |
  | `filterByApiKey` | `boolean`                                                         | When true, return only logs for the Authorization header key. When false, return all keys under the account or organization.                  |
</div>