// api reference

Reputation

GETA buyer's or a seller's reputation events, newest first
POSTVoid a reputation event, with a written reason

GET /v1/reputation_events

A buyer's or a seller's reputation events, newest first

secret key only

GET /v1/reputation_eventsrequest

curl https://api.marketsdk.com/v1/reputation_events \
  -H "Authorization: Bearer $MARKETSDK_KEY"

200 example response, reputation event list

{
  "object": "list",
  "data": [
    {
      "object": "reputation_event",
      "id": "rep_034XtPDs7UJ0TXzTsdaHZa",
      "party": "string",
      "party_role": "buyer",
      "kind": "order_completed",
      "order": null,
      "review": null,
      "rating": null,
      "voids": null,
      "reason": null,
      "occurred_at": "2026-10-01T12:00:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

parameters

Parameters
field	type	about
limit	integer, in query	min 1, max 100, default 20
starting_after	string, in query	The `next_cursor` of the previous page.
partyrequired	string, in query	The buyer or seller whose events to list.

returns 200, reputation event list

fields

Response fields
field	type	about
objectrequired	one of: list
datarequired	array of reputation event
data[].objectrequired	one of: reputation_event
data[].idrequired	string
data[].partyrequired	string	The buyer or seller the event belongs to.
data[].party_rolerequired	one of: buyer, seller
data[].kindrequired	one of: order_completed, backed_out, dispute_lost, dispute_won, lapsed, review_received, voided
data[].orderrequired	string or null
data[].reviewrequired	string or null
data[].ratingrequired	integer or null	For review_received.
data[].voidsrequired	string or null	For voided: the event this one voids.
data[].reasonrequired	string or null	For voided: the written reason.
data[].occurred_atrequired	timestamp
has_morerequired	boolean	Whether another page follows.
next_cursorrequired	string or null	Pass as `starting_after` (or `cursor` for search) to get the next page.

errors

400The request is not valid.
401No API key, or not a valid one.
429Rate limited. See Retry-After.

POST /v1/reputation_events/{id}/void

Void a reputation event, with a written reason

For the customer's team. Writes a second event pointing at the first. The voided event stops counting. Nothing is deleted.

secret key only

POST /v1/reputation_events/{id}/voidrequest

curl -X POST https://api.marketsdk.com/v1/reputation_events/{id}/void \
  -H "Authorization: Bearer $MARKETSDK_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"reason":"string"}'

200 example response, reputation event

{
  "object": "reputation_event",
  "id": "rep_034XtPDs7UJ0TXzTsdaHZa",
  "party": "string",
  "party_role": "buyer",
  "kind": "order_completed",
  "order": null,
  "review": null,
  "rating": null,
  "voids": null,
  "reason": null,
  "occurred_at": "2026-10-01T12:00:00.000Z"
}

parameters

Parameters
field	type	about
idrequired	string, in path

body, void

Request body
field	type	about
reasonrequired	string	Why the event is voided. Recorded on the voiding event.up to 1000 characters

returns 200, reputation event

fields

Response fields
field	type	about
objectrequired	one of: reputation_event
idrequired	string
partyrequired	string	The buyer or seller the event belongs to.
party_rolerequired	one of: buyer, seller
kindrequired	one of: order_completed, backed_out, dispute_lost, dispute_won, lapsed, review_received, voided
orderrequired	string or null
reviewrequired	string or null
ratingrequired	integer or null	For review_received.
voidsrequired	string or null	For voided: the event this one voids.
reasonrequired	string or null	For voided: the written reason.
occurred_atrequired	timestamp

errors

400The request is not valid.
401No API key, or not a valid one.
404No object with that id in this marketplace.
409The object is not in a state that allows this.
429Rate limited. See Retry-After.