> ## Documentation Index > Fetch the complete documentation index at: https://docs.tinyfish.ai/llms.txt > Use this file to discover all available pages before exploring further. # List fetch usage > List fetch usage records for the authenticated user. Returns paginated results with URL, format, status, and metadata for each fetch operation. ## OpenAPI ````yaml https://agent.tinyfish.ai/v1/openapi/fetch get /usage openapi: 3.0.0 info: title: TinyFish Fetch API version: 1.0.0 description: Fetch URLs and extract clean page content. contact: name: TinyFish Support email: support@tinyfish.ai servers: - url: https://api.fetch.tinyfish.ai security: [] paths: /usage: get: summary: List fetch usage description: >- List fetch usage records for the authenticated user. Returns paginated results with URL, format, status, and metadata for each fetch operation. operationId: listFetchUsage parameters: - schema: type: string format: date-time required: false name: start_after in: query - schema: type: string format: date-time required: false name: end_before in: query - schema: type: string enum: - completed - failed required: false name: status in: query - schema: type: integer minimum: 1 maximum: 1000 default: 100 required: false name: limit in: query - schema: type: integer minimum: 1 default: 1 required: false name: page in: query responses: '200': description: Fetch usage retrieved successfully. content: application/json: schema: type: object properties: items: type: array items: type: object properties: id: type: string url: type: string final_url: type: string title: type: string nullable: true description: type: string nullable: true language: type: string nullable: true author: type: string nullable: true published_date: type: string nullable: true format: type: string enum: - markdown - html - json status: type: string enum: - completed - failed request_origin: type: string request_id: type: string nullable: true text_length: type: integer nullable: true links_count: type: integer image_links_count: type: integer latency_ms: type: number nullable: true not_modified: type: boolean description: >- Present and `true` only when that fetch was a conditional request that returned 304 Not Modified; omitted otherwise. example: true etag: type: string description: >- 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. example: W/"abc123" last_modified: type: string description: >- 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. example: Wed, 21 Oct 2015 07:28:00 GMT created_at: type: string format: date-time error: type: string nullable: true required: - id - url - final_url - title - description - language - author - published_date - format - status - request_origin - request_id - text_length - links_count - image_links_count - latency_ms - created_at - error description: A single fetch usage record total: type: integer limit: type: integer page: type: integer total_pages: type: integer has_more: type: boolean required: - items - total - limit - page - total_pages - has_more description: Paginated fetch usage response example: items: - id: fr-abc123 url: https://example.com final_url: https://example.com/page title: Example Page description: An example page language: en author: null published_date: null format: markdown status: completed request_origin: api request_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 text_length: 4096 links_count: 12 image_links_count: 3 latency_ms: 250 created_at: '2026-01-14T10:30:00.000Z' error: null total: 1 limit: 100 page: 1 total_pages: 1 has_more: false '400': description: Invalid query parameters content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - MISSING_API_KEY - INVALID_API_KEY - INVALID_INPUT - RATE_LIMIT_EXCEEDED - INTERNAL_ERROR - RETRY_REQUIRED - UNAUTHORIZED - FORBIDDEN - NOT_FOUND - SERVICE_BUSY - TIMEOUT - INSUFFICIENT_CREDITS - CONTENT_POLICY_VIOLATION - MAX_STEPS_EXCEEDED - SITE_BLOCKED - TASK_FAILED - CANCELLED description: Machine-readable error code example: INVALID_INPUT message: type: string description: Human-readable error message example: Field "url" is required and must be a string details: nullable: true description: Additional error details (validation errors, etc.) required: - code - message required: - error description: Standard error response format '401': description: Unauthorized - Invalid or missing API key content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - MISSING_API_KEY - INVALID_API_KEY - INVALID_INPUT - RATE_LIMIT_EXCEEDED - INTERNAL_ERROR - RETRY_REQUIRED - UNAUTHORIZED - FORBIDDEN - NOT_FOUND - SERVICE_BUSY - TIMEOUT - INSUFFICIENT_CREDITS - CONTENT_POLICY_VIOLATION - MAX_STEPS_EXCEEDED - SITE_BLOCKED - TASK_FAILED - CANCELLED description: Machine-readable error code example: INVALID_INPUT message: type: string description: Human-readable error message example: Field "url" is required and must be a string details: nullable: true description: Additional error details (validation errors, etc.) required: - code - message required: - error description: Standard error response format '500': description: Internal server error content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - MISSING_API_KEY - INVALID_API_KEY - INVALID_INPUT - RATE_LIMIT_EXCEEDED - INTERNAL_ERROR - RETRY_REQUIRED - UNAUTHORIZED - FORBIDDEN - NOT_FOUND - SERVICE_BUSY - TIMEOUT - INSUFFICIENT_CREDITS - CONTENT_POLICY_VIOLATION - MAX_STEPS_EXCEEDED - SITE_BLOCKED - TASK_FAILED - CANCELLED description: Machine-readable error code example: INVALID_INPUT message: type: string description: Human-readable error message example: Field "url" is required and must be a string details: nullable: true description: Additional error details (validation errors, etc.) required: - code - message required: - error description: Standard error response format security: - ApiKeyAuth: [] components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: API key for authentication. Get your key from the API Keys page. ````