---
title: "Validate a domain's releases.json and preview its listing"
method: POST
path: "/listing/validate"
tags: ["Listing"]
---

# Validate a domain's releases.json and preview its listing

`POST /listing/validate`

Fetches https://{domain}/.well-known/releases.json live (HTTPS-only, 64KB, 5s), validates it against the v2 manifest schema, and returns a preview: identity, products, and per-locator classification, plus whether the domain is already listed. Public and anonymous; rate limited.

## Request body

- object
  - `domain` string, required

## Response `200`

ListingValidationResult

## Other responses

- `404` — Lane disabled
- `429` — Rate limited

## Changes

- **2026-08-31** `ef21361a36e6` — 1 info
  - added the media type `application/json` for the response with the status `404`
- **2026-08-25** `c3a92b6b6909` — 1 warning
  - added the new `too_large` enum value to the `error/type` response property for the response status `429`

[Change history](https://skmtc.dev/releases/apis/releases-api/changes/listing/validate/post.md)

---

[API](https://skmtc.dev/releases/apis/releases-api.md) · [All operations](https://skmtc.dev/releases/apis/releases-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/releases/releases-api/revisions/ef21361a36e6/schema)