Confirm the listing exists
payTo. If your endpoint is here, cataloging worked.
Confirm it is searchable
describe block (see Declaring Discovery Metadata).
Nothing there?
In order of likelihood:- No
describeblock. Cataloging only fires whendescribeis present. - Facilitator URL mismatch. Confirm your middleware is pointed at the same facilitator you are querying.
- No traffic yet. Cataloging can be lazy on some builds. Send one real
402(a test buyer orcurl -X GET) to trigger it. - Server not exposed. If your endpoint is behind a private hostname the facilitator cannot reach, delisting kicks in fast. Bind a publicly resolvable URL.
Ranked lower than expected?
Use the debug endpoint:debug block breaking down its score. Common causes of a low rank:
- Sparse
describe: title and description carry most of the weight. - Low settle-to-verify ratio: buyers are quoting your endpoint but not paying, which suggests either your prices are off or your response schema does not match
outputs. - Very new listing: fresh-boost ends after 48 hours. If you were only tested for two days, ranking drops.
Delist a listing you no longer want
payTo. See the API reference for the exact challenge/response.