---
title: "List an x402 paid API for agent discovery"
method: POST
path: "/api/x402/list-service"
tags: ["x402-listing", "paid-api-discovery", "directory"]
---

# List an x402 paid API for agent discovery

`POST /api/x402/list-service`

Validate and publish a third-party x402 service in Ontario's discovery feed. The 0.50 USDC fee covers a production launch passport and 30 days of included automatic freshness maintenance; it does not purchase a readiness grade, certification, endorsement, or guaranteed traffic.

## Request body

- object
  - `description` string, required
  - `endpoint` string, uri, required
  - `method` string
  - `name` string, required
  - `network` string
  - `owner_contact` string
  - `owner_url` string, uri
  - `price_usdc` string, required
  - `source` 'coinbase_bazaar' | 'direct_or_unknown' | 'github' | 'google_search' | 'internal_navigation' | 'mcp_registry' | 'other_search' — Privacy-safe aggregate acquisition bucket; never a URL or query.
  - `tags` string[]

## Response `200`

Service registered

- object
  - `listing` object
  - `status` string

## Other responses

- `402` — Payment required

---

[API](https://skmtc.net/ontarioprotocol/apis/ontario-protocol-x402-api.md) · [All operations](https://skmtc.net/ontarioprotocol/apis/ontario-protocol-x402-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ontarioprotocol/ontario-protocol-x402-api/revisions/54384a1c4bf3/schema)