---
title: "Submit a free pending x402 service listing"
method: POST
path: "/api/x402/list-service/request"
---

# Submit a free pending x402 service listing

`POST /api/x402/list-service/request`

Validates and stores a provider submission as pending without payment. Pending entries are excluded from strict discovery until readiness evidence is available.

## 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
  - `tags` string[]
  - `verify_now` boolean — Run the free readiness verifier and return a report summary while keeping the listing pending.

## Response `202`

Pending listing stored without payment

## Other responses

- `400` — Listing payload validation failed
- `429` — Free pending submission limit reached

---

[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)