API ReferenceListings

Check a listing with the channel without publishing

POST /rest/v1/listings/{id}/validate

POST
/listings/{id}/validate

Amazon listings: Amazon's own check (VALIDATION_PREVIEW) of what a publish would send, with the listing's product type, attributes and condition. Nothing is created or changed on Amazon. Other channels answer 422 not_supported_for_channel. Required scope: listings:write.

AuthorizationBearer <token>

Authorization: Bearer nbl_live_... (or nbl_test_... for test mode). Test-mode writes are validated and simulated but never persisted and never touch channels; simulated results are marked simulated.

In: header

Path Parameters

id*string

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/listings/string/validate"
{  "object": "listing_validation",  "listing_id": "string",  "valid": true,  "status": "VALID",  "message": "string",  "issues": [    {      "code": "string",      "message": "string",      "fields": [        "string"      ]    }  ]}

Need help?

Email us and a human replies, usually within one business day.