← Back to directory

Use when an agent must see the files it stored. Pay from the same wallet (Base o...

https://1gateway.dev/v1/files/list

Overview

Use when an agent must see the files it stored. Pay from the same wallet (Base or Monad USDC). Input: optional cursor. Output: up to 100 files (id, mime, size, visibility, expiry, url if public), nextCursor, and usage against the limits (500 MB, 50 uploads per 24 h). Example: /v1/files/list

Protocol x402
Price $0.0020
Payment Asset USD Coin
Payment Network eip155:8453
Category crypto/wallet
Provider Agent File Storage
Source bazaar
Indexed 2026-11-09 18:08:03

Health

Status unknown
Latency (p50) —
Uptime (30d) —
Reliability Score —
Last Checked Never
Last Healthy Never
Consecutive Failures 0

x402 Payment Validation

Payment Requirements —
Asset Verified —
Facilitator —

Input Schema

{ "method": "GET", "queryParams": {}, "type": "http" }

Output Schema

{ "example": { "files": [ { "createdAt": "2026-11-09T00:00:00.000Z", "expiresAt": "2026-11-16T00:00:00.000Z", "filename": "chart.png", "id": "fedcba9876543210fedcba9876543210", "mime": "image/png", "sha256": "63ef318d96b5d0d0ceba6e04a4e622b1158335cdc67c49e27839132c6f655058", "size": 68, "url": "https://1storage.dev/f/fedcba9876543210fedcba9876543210", "visibility": "public" } ], "nextCursor": null, "usage": { "bytes": 130, "files": 2, "maxFileBytes": 26214400, "maxImageBytes": 5242880, "maxTextBytes": 262144, "maxUploadsPerDay": 50, "maxWalletBytes": 524288000, "uploadsLast24h": 2 } }, "type": "json" }