# nohumans.directory Purchase History for a Listing

> nohumans.directory Purchase History for a Listing is a paid API for AI agents from api.nohumans.directory, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Returns the full longitudinal purchase history for a specific API listing, including every real USDC payment made, delivery outcomes, body changes, and freshness metadata.

## Facts

- Endpoint: GET https://api.nohumans.directory/v1/listings/%7Bid%7D/purchases?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nohumans-directory-purchase-history-for-a-listing-b4d109e0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_F179VaxDjk6NFg-DMHMTS

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 nohumans-directory-purchase-history-for-a-listing-b4d109e0
```

Example prompt: Pull up the full purchase history for listing ID 00000000-000 on nohumans.directory — I want to see every real USDC payment, whether each one was delivered, and whether the response body changed between purchases.

## When to prefer this

Use this endpoint when an agent needs longitudinal, verified purchase evidence for a specific x402 API listing — not just metadata or a pre-spend verdict, but actual historical transactions with delivery confirmation, body-change tracking, and USDC amounts paid. Prefer this over the pre-spend verdict endpoint when you need full audit depth rather than a quick go/no-go signal.

## Known failure modes

- Listing ID not found — returns 404 if the ID does not exist in the directory
- No purchase history yet — returns empty purchases array if the listing has never been probed
- Malformed listing ID in path — returns 400 if the ID format is invalid
- Temporary unavailability — directory service may return 503 under load
- Payment required — $0.01 USDC x402 payment must succeed before data is returned

## How this service works

Registry of paid x402 APIs and datasets for AI agents. Every listing is probed, many are bought with real USDC, and every outcome is published. Free API + MCP.

## Output

Returns a JSON object containing: a list of individual purchase records (each with tx_hash, outcome, delivered flag, freshness, body_bytes, quote_usdc, amount_paid_usdc, http_status, data_age_seconds, body_hash_norm, response_valid_json, response_matches_schema, attempted_at), a summary object (total purchases, first and last timestamps, number delivered, price moves, last outcome, body changes observed), a list of body-change pairs showing before/after timestamps and whether body or price changed, and top-level status (e.g. 'verified') plus the rule URL and as_of timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "rule": "https://nohumans.directory/methodology#purchases",
  "as_of": 1790000000,
  "pairs": [
   {
    "to": 1789457000,
    "body": "changed",
    "from": 1788900000,
    "price": "held",
    "delivery": "held",
    "days_apart": 6.4,
    "quote_delta_usdc": 0
   }
  ],
  "status": "verified",
  "summary": {
   "last_at": 1789457000,
   "first_at": 1788900000,
   "delivered": 2,
   "purchases": 2,
   "price_moves": 0,
   "hashed_pairs": 1,
   "last_outcome": "delivered",
   "body_changes_observed": 1
  },
  "purchases": [
   {
    "outcome": "delivered",
    "tx_hash": "0x…",
    "delivered": true,
    "freshness": "fresh",
    "body_bytes": 812,
    "quote_usdc": 0.005,
    "http_status": 200,
    "attempted_at": 1788900000,
    "body_hash_norm": "…",
    "amount_paid_usdc": 0.005,
    "data_age_seconds": 12,
    "listed_price_usdc": 0.005,
    "response_valid_json": 1,
    "response_matches_schema": 1
   },
   {
    "outcome": "delivered",
    "tx_hash": "0x…",
    "delivered": true,
    "freshness": "fresh",
    "body_bytes": 830,
    "quote_usdc": 0.005,
    "http_status": 200,
    "attempted_at": 1789457000,
    "body_hash_norm": "…",
    "amount_paid_usdc": 0.005,
    "data_age_seconds": 9,
    "listed_price_usdc": 0.005,
    "response_valid_json": 1,
    "response_matches_schema": 1
   }
  ],
  "listing_id": "00000000-000",
  "endpoint_url": "https://seller.example/v1/quote"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nohumans-directory-purchase-history-for-a-listing-b4d109e0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.nohumans.directory](https://www.zero.xyz/host/api.nohumans.directory/llms.txt)