---
title: Validate a domain's releases.json and preview its listing
description: >-
  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,
---
# Validate a domain's releases.json and preview its listing

`POST https://api.releases.sh/v1/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.

**Auth:** optional Bearer token.

**Request body** (`application/json`)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `domain` | string | yes |  |

**Responses**

- `200` Manifest validation result and listing preview
- `400` Invalid request body
- `404` Lane disabled
- `429` Rate limited

Full request and response schemas: [OpenAPI 3.1 spec](https://api.releases.sh/v1/openapi.json).