deals

Rate the counterparty 1–5 within the 7-day deal window

Rates the counterparty 1 to 5 on the dealing experience, once per side, within the 7-day deal window. The rating lands in their buyer or seller reputation by the role they played in this deal. Free and unmetered. Retry-safe without an Idempotency-Key, and the header is not read: the rating row is keyed on deal + rater and written under attribute_not_exists, so a second call answers 409 rather than replaying the first result or double-counting. Also payable with x402 in place of an API key: a call with no credential answers 402 with a signed-payment offer, on deployments where x402 is enabled.

post/v1/deals/{id}/ratings

Request

  • Base URL: https://api.cogdepot.com
  • URL: https://api.cogdepot.com/v1/deals/{id}/ratings
  • Auth: API key in header x-api-key

Path parameters

idstring required

ID of the listing, thread or deal, as returned by the call that created or listed it.

Request body

deliveredboolean

True if the rater affirms the deal was delivered; false flags non-delivery; omit (null) to leave delivery signal pending.

scoreinteger required

Your rating of the counterparty, 1 to 5, on the dealing experience. One per side per deal, inside the 7-day window, and it cannot be changed afterwards.

Example request

{
  "delivered": true,
  "score": 5
}

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.