---
title: "List fetch usage"
method: GET
path: "/fetch/usage"
tags: ["Fetch"]
---

# List fetch usage

`GET /fetch/usage`

## Request

- Base URL: `https://api.fetch.tinyfish.ai`
- URL: `https://api.fetch.tinyfish.ai/fetch/usage`
- Auth: API key in header `X-API-Key`

List fetch usage records for the authenticated user. Returns paginated results with URL, format, status, and metadata for each fetch operation.

## Query parameters

- `start_after` string, date-time
- `end_before` string, date-time
- `status` 'completed' | 'failed'
- `limit` integer
- `page` integer

## Response `200`

Fetch usage retrieved successfully.

- object: Paginated fetch usage response
  - `items` object[], required
    - `id` string, required
    - `url` string, required
    - `final_url` string, required
    - `title` string, nullable, required
    - `description` string, nullable, required
    - `language` string, nullable, required
    - `author` string, nullable, required
    - `published_date` string, nullable, required
    - `format` 'markdown' | 'html' | 'json', required
    - `status` 'completed' | 'failed', required
    - `request_origin` string, required
    - `request_id` string, nullable, required
    - `text_length` integer, nullable, required
    - `links_count` integer, required
    - `image_links_count` integer, required
    - `latency_ms` number, nullable, required
    - `not_modified` boolean: Present and `true` only when that fetch was a conditional request that returned 304 Not Modified; omitted otherwise.
    - `etag` string: The origin's ETag validator captured at fetch time, present only when `include_etag_and_last_modified` was set on that request and the origin returned one; omitted otherwise.
    - `last_modified` string: The origin's Last-Modified validator captured at fetch time, present only when `include_etag_and_last_modified` was set on that request and the origin returned one; omitted otherwise.
    - `created_at` string, date-time, required
    - `error` string, nullable, required
  - `total` integer, required
  - `limit` integer, required
  - `page` integer, required
  - `total_pages` integer, required
  - `has_more` boolean, required

## Other responses

- `400`: Invalid query parameters
- `401`: Unauthorized - Invalid or missing API key
- `500`: Internal server error

---

[API](https://skmtc.dev/tinyfish/apis/tinyfish-web-agent-automation-api-2.md) · [All operations](https://skmtc.dev/tinyfish/apis/tinyfish-web-agent-automation-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/tinyfish/apis/tinyfish-web-agent-automation-api-2/revisions/6c73a54df35c?raw)