# Tanship PayAI Console — Storage List API (x402)

> Tanship PayAI Console — Storage List API (x402) is a paid API for AI agents from x402.tanship.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-10).

Lists stored objects or files in Tanship's payment-gated storage service, requiring a $0.003 USDC micropayment via x402 on Base before returning results.

## Facts

- Endpoint: POST https://x402.tanship.dev/v1/storage/list?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tanship-payai-console-storage-list-api-x402-c3b12af4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2Lrm7pDFcXtUSt9Ofx-5V

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tanship-payai-console-storage-list-api-x402-c3b12af4 -d '<json body>'
```

Example prompt: Can you list all the files I've stored in my Tanship storage? Pay the USDC fee via x402 and show me what's there.

## When to prefer this

Use this endpoint when an AI agent needs to enumerate or audit the contents of Tanship's payment-gated storage service and is already operating in a x402-enabled micropayment environment on the Base blockchain. Prefer this over generic cloud storage APIs when the workflow is built around Tanship's PayAI ecosystem or when USDC micropayments per call are acceptable and desired for permissionless, trustless access control.

## Known failure modes

- Payment not included or insufficient USDC — returns HTTP 402 with x402 payment requirements
- Invalid or malformed POST body — returns 400 with schema validation error
- Storage is empty — returns an empty list rather than an error
- Authentication or wallet mismatch — may return 401 or 403
- Network or Base chain payment confirmation delay — transient 402 or timeout
- Unsupported bodyType value — returns 400 schema error

## How this service works

Payment-gated AI and browser automation API using the x402 protocol. All /v1/* endpoints require USDC payment on Base (eip155:8453) via x402 v2 exact scheme.

## Output

Returns a list of stored objects or files in the Tanship storage service, including metadata such as object keys, names, or identifiers for each stored item. The response reflects the current state of the caller's storage after the $0.003 USDC x402 payment is verified.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tanship-payai-console-storage-list-api-x402-c3b12af4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.tanship.dev](https://www.zero.xyz/host/x402.tanship.dev/llms.txt)
