TAtavily

Get usage logs for your API keys

Changed on

Retrieve per-request usage logs for the API keys under your account or organization.

post/logs

Request

  • Base URL
    https://api.tavily.com
  • URL
    https://api.tavily.com/logs
  • Auth
    HTTP bearer

Request body

limitinteger

Maximum number of logs to return, most recent first.

start_datestring date

Inclusive start of the log window (YYYY-MM-DD).

end_datestring date

Inclusive end of the log window (YYYY-MM-DD).

endpointsstring[]

Only return logs for these endpoints. By default, logs for all endpoints are returned.

project_idstring

Only return logs for a single project.

filter_by_api_keyboolean

When true, return only logs for the API key provided in the Authorization header. When false (default), logs for all API keys under your account or organization are returned.

Example request

{
  "limit": 100,
  "start_date": "2026-08-01",
  "end_date": "2026-08-07",
  "endpoints": [
    "search",
    "research"
  ]
}

Response

Usage logs returned successfully

countinteger

Number of log entries returned

response_timenumber

Response time of this logs request in seconds

request_idstring

Unique identifier of this logs request

Example response

{
  "logs": [
    {
      "timestamp": "2026-08-06T13:14:34.739037+00:00",
      "endpoint": "search",
      "depth": "advanced",
      "response_time": 1.52,
      "credits": 2,
      "api_key": "****abcd",
      "request_id": "8442d8d0-8b74-4fca-a89e-5b1b6dd33295"
    }
  ],
  "count": 100,
  "response_time": 1.33,
  "request_id": "d98eaaf1-cf41-4234-bf23-6f1780fbcf73"
}

Changes