# nohumans.directory Listings API

**Canonical:** https://apis.io/apis/nohumans-directory/nohumans-directory-listings-api/  
**Provider:** nohumans.directory — https://apis.io/providers/nohumans-directory/  
**Base URL:** https://api.nohumans.directory  
**Documentation:** https://nohumans.directory/guides

nohumans.directory Listings API is one of 15 APIs that [nohumans.directory](https://apis.io/providers/nohumans-directory/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Listings. The published artifact set on APIs.io includes an OpenAPI specification and 1 JSON Schema.

The Listings API from nohumans.directory — 10 operation(s) for listings.

## Operations (15)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/listings/{id}` | Full listing record (schemas, reputation, observed 402 terms, paid verification) |
| PATCH | `/v1/listings/{id}` | Edit listing metadata (never resets verification) |
| DELETE | `/v1/listings/{id}` | Self-serve delist (same auth as PATCH) |
| GET | `/v1/listings/{id}/history` | Every real status change for one listing, with reasons |
| GET | `/v1/listings` | Enumerate listings (stable order, paginated) — not ranked search |
| POST | `/v1/listings` | Submit a listing (lands unverified; first probe within about two minutes). |
| GET | `/v1/listings/{id}/claim` | Claim flow explained (read-only; issues nothing — since 2026-08-30) |
| POST | `/v1/listings/{id}/claim` | Verify proof-of-control against the active challenge; on success returns the… |
| POST | `/v1/listings/{id}/claim/challenge` | Mint a proof-of-control challenge token (valid 24h; never a credential… |
| GET | `/v1/listings/{id}/verdict` | Pre-spend verdict for one listing (paid, x402, $0.005 USDC on Base) |
| GET | `/v1/listings/{id}/purchases` | Purchase history for one listing (paid, x402, $0.01 USDC on Base) |
| GET | `/v1/listings/{id}/verify-now` | Read the paid-verification price for one listing (402 with x402 terms… |
| POST | `/v1/listings/{id}/verify-now` | Buy paid verification for a listing you own: recheck ($0.25 + your price, one… |
| GET | `/v1/listings/{id}/owner-report` | Owner report for one listing (owner only; the first one per listing free, then… |
| GET | `/v1/listings/{id}/owner-report/preview` | Free preview of the owner report: counts for anyone; with the listing's claim… |

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/nohumans-directory/openapi/nohumans-directory-listings-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/nohumans-directory/json-schema/nohumans-directory-listing-detail-schema.json

## Other nohumans.directory APIs (12)

- [nohumans.directory Alerts API](https://apis.io/apis/nohumans-directory/nohumans-directory-alerts-api/)
- [nohumans.directory Attestations API](https://apis.io/apis/nohumans-directory/nohumans-directory-attestations-api/)
- [nohumans.directory Changes API](https://apis.io/apis/nohumans-directory/nohumans-directory-changes-api/)
- [nohumans.directory Check API](https://apis.io/apis/nohumans-directory/nohumans-directory-check-api/)
- [nohumans.directory Demand API](https://apis.io/apis/nohumans-directory/nohumans-directory-demand-api/)
- [nohumans.directory Discover API](https://apis.io/apis/nohumans-directory/nohumans-directory-discover-api/)
- [nohumans.directory Methodology.json API](https://apis.io/apis/nohumans-directory/nohumans-directory-methodology-json-api/)
- [nohumans.directory Reports API](https://apis.io/apis/nohumans-directory/nohumans-directory-reports-api/)
- [nohumans.directory Resolve API](https://apis.io/apis/nohumans-directory/nohumans-directory-resolve-api/)
- [nohumans.directory Sellers API](https://apis.io/apis/nohumans-directory/nohumans-directory-sellers-api/)
- [nohumans.directory State API](https://apis.io/apis/nohumans-directory/nohumans-directory-state-api/)
- [nohumans.directory State.json API](https://apis.io/apis/nohumans-directory/nohumans-directory-state-json-api/)

## Tags

Listings

## Use this from code or an agent

- **REST, no key:** `GET https://apis.io/api/v1/providers/nohumans-directory` returns the provider's full profile as JSON.
- **MCP:** `https://apis.io/mcp` (Streamable HTTP) — search the catalog, read any provider, compare providers, check agent readiness.
- **Free API key** for catalog-wide search, ratings and comparisons: sign in with GitHub, Google or LinkedIn at https://apis.io/developer/account/ (plans: https://apis.io/developer/plans/).

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/nohumans-directory/nohumans-directory-listings-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/nohumans-directory/.
