# JSON API Shape Inspector

> JSON API Shape Inspector is a paid API for AI agents from holder-victor-nova-mag.trycloudflare.com, paid per call via x402, $0.05/call, status down (last checked 2026-09-15).

Fetches a public JSON API URL and inventories the bounded set of observed key paths and value types, returning structural shape with status code and SHA-256 hash evidence but no raw values.

## Facts

- Endpoint: GET https://holder-victor-nova-mag.trycloudflare.com/x402/json-api-shape
- Price: $0.05/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/json-api-shape-inspector-b1a9fd98
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZV9KqqQIdZLeyb-s0LGec

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 json-api-shape-inspector-b1a9fd98
```

Example prompt: Can you inspect the JSON structure of https://api.example.com/v1/products — show me the key paths and value types (up to depth 3 and 40 paths) without revealing any actual data values?

## When to prefer this

Use this endpoint when you need to discover or document the structural shape of a public JSON API without exposing sensitive raw values. It is ideal for API integration planning, schema discovery, or structural auditing where privacy or data minimization matters. Prefer this over full response capture endpoints when you only need the key/type inventory and want SHA-256 evidence of the response without storing actual data.

## Known failure modes

- URL is not publicly accessible or requires authentication — returns error indicating unauthenticated access failed
- URL does not return valid JSON — shape cannot be parsed
- maxDepth or maxPaths limits exceeded — result is truncated to configured bounds
- Target server times out or returns non-200 status — error with status code returned
- URL is malformed or not a valid URI — schema validation error

## How this service works

Inventory bounded observed key and type paths from one unauthenticated public JSON API response, with status and SHA-256 evidence but no raw values.

## Output

Returns a bounded inventory of observed key paths and their inferred types from the JSON API response, along with the HTTP status code and a SHA-256 hash of the response body as evidence. No raw field values are included — only structural shape metadata.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "format": "uri"
      },
      "maxDepth": {
       "type": "integer",
       "default": 4,
       "maximum": 6,
       "minimum": 1
      },
      "maxPaths": {
       "type": "integer",
       "default": 50,
       "maximum": 100,
       "minimum": 1
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/json-api-shape-inspector-b1a9fd98/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from holder-victor-nova-mag.trycloudflare.com](https://www.zero.xyz/host/holder-victor-nova-mag.trycloudflare.com/llms.txt)