// api reference

Moderation

GETList flags, newest first
POSTFlag a listing, a seller, or a review
GETRetrieve a flag
GETThe review queue: everything with open flags, the longest waiting first
GETThe moderation log, newest first
POSTAct on a flagged target

GET /v1/flags

List flags, newest first

secret key only

GET /v1/flagsrequest

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

200 example response, flag list

{
  "object": "list",
  "data": [
    {
      "object": "flag",
      "id": "flg_034XtPDs7UJ0TXzTsdaHZa",
      "target_type": "listing",
      "target": "string",
      "reporter": "string",
      "reason": "prohibited_item",
      "note": null,
      "status": "open",
      "resolution": "dismissed",
      "action": null,
      "created_at": "2026-10-01T12:00:00.000Z",
      "resolved_at": null
    }
  ],
  "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.
status	one of: open, resolved, in query
target	string, in query	Only flags on this listing, seller, or review.

returns 200, flag list

fields

Response fields
field	type	about
objectrequired	one of: list
datarequired	array of flag
data[].objectrequired	one of: flag
data[].idrequired	string
data[].target_typerequired	one of: listing, seller, review
data[].targetrequired	string
data[].reporterrequired	string
data[].reasonrequired	one of: prohibited_item, counterfeit, scam, offensive, spam, other
data[].noterequired	string or null
data[].statusrequired	one of: open, resolved
data[].resolutionrequired	one of: dismissed, content_removed, seller_suspended, null or null
data[].actionrequired	string or null	The moderation action that resolved it.
data[].created_atrequired	timestamp
data[].resolved_atrequired	timestamp or null
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/flags

Flag a listing, a seller, or a review

On behalf of the end user who reported it.

secret key only

POST /v1/flagsrequest

curl -X POST https://api.marketsdk.com/v1/flags \
  -H "Authorization: Bearer $MARKETSDK_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"target":"lst_034XtPDs7UJ0TXzTsdaHZa","reporter":"buy_034XtPDs7UJ0TXzTsdaHZa","reason":"prohibited_item"}'

201 example response, flag

{
  "object": "flag",
  "id": "flg_034XtPDs7UJ0TXzTsdaHZa",
  "target_type": "listing",
  "target": "string",
  "reporter": "string",
  "reason": "prohibited_item",
  "note": null,
  "status": "open",
  "resolution": "dismissed",
  "action": null,
  "created_at": "2026-10-01T12:00:00.000Z",
  "resolved_at": null
}

body, create flag

Request body
field	type	about
targetrequired	string	A listing, seller, or review id.
reporterrequired	string	The end user reporting it: a buyer id or a seller id.
reasonrequired	one of: prohibited_item, counterfeit, scam, offensive, spam, other
note	string	The reporter's own words.up to 2000 characters

returns 201, flag

fields

Response fields
field	type	about
objectrequired	one of: flag
idrequired	string
target_typerequired	one of: listing, seller, review
targetrequired	string
reporterrequired	string
reasonrequired	one of: prohibited_item, counterfeit, scam, offensive, spam, other
noterequired	string or null
statusrequired	one of: open, resolved
resolutionrequired	one of: dismissed, content_removed, seller_suspended, null or null
actionrequired	string or null	The moderation action that resolved it.
created_atrequired	timestamp
resolved_atrequired	timestamp or null

errors

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

GET /v1/flags/{id}

Retrieve a flag

secret key only

GET /v1/flags/{id}request

curl https://api.marketsdk.com/v1/flags/{id} \
  -H "Authorization: Bearer $MARKETSDK_KEY"

200 example response, flag

{
  "object": "flag",
  "id": "flg_034XtPDs7UJ0TXzTsdaHZa",
  "target_type": "listing",
  "target": "string",
  "reporter": "string",
  "reason": "prohibited_item",
  "note": null,
  "status": "open",
  "resolution": "dismissed",
  "action": null,
  "created_at": "2026-10-01T12:00:00.000Z",
  "resolved_at": null
}

parameters

Parameters
field	type	about
idrequired	string, in path

returns 200, flag

fields

Response fields
field	type	about
objectrequired	one of: flag
idrequired	string
target_typerequired	one of: listing, seller, review
targetrequired	string
reporterrequired	string
reasonrequired	one of: prohibited_item, counterfeit, scam, offensive, spam, other
noterequired	string or null
statusrequired	one of: open, resolved
resolutionrequired	one of: dismissed, content_removed, seller_suspended, null or null
actionrequired	string or null	The moderation action that resolved it.
created_atrequired	timestamp
resolved_atrequired	timestamp or null

errors

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

GET /v1/moderation/queue

The review queue: everything with open flags, the longest waiting first

secret key only

GET /v1/moderation/queuerequest

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

200 example response, moderation queue

{
  "object": "list",
  "data": [
    {
      "object": "moderation_queue_item",
      "target_type": "listing",
      "target": "string",
      "open_flags": 0,
      "reasons": {},
      "first_flagged_at": "2026-10-01T12:00:00.000Z",
      "last_flagged_at": "2026-10-01T12:00:00.000Z"
    }
  ]
}

parameters

Parameters
field	type	about
target_type	one of: listing, seller, review, in query

returns 200, moderation queue

fields

Response fields
field	type	about
objectrequired	one of: list
datarequired	array of queue item	Targets with open flags, the longest waiting first. At most 100.
data[].objectrequired	one of: moderation_queue_item
data[].target_typerequired	one of: listing, seller, review
data[].targetrequired	string
data[].open_flagsrequired	integer
data[].reasonsrequired	object of strings	Open flags by reason.
data[].first_flagged_atrequired	timestamp
data[].last_flagged_atrequired	timestamp

errors

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

GET /v1/moderation/actions

The moderation log, newest first

secret key only

GET /v1/moderation/actionsrequest

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

200 example response, moderation action list

{
  "object": "list",
  "data": [
    {
      "object": "moderation_action",
      "id": "mod_034XtPDs7UJ0TXzTsdaHZa",
      "target_type": "listing",
      "target": "string",
      "action": "dismiss",
      "reason": "string",
      "actor": "string",
      "flags_resolved": 0,
      "created_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.
target	string, in query

returns 200, moderation action list

fields

Response fields
field	type	about
objectrequired	one of: list
datarequired	array of moderation action
data[].objectrequired	one of: moderation_action
data[].idrequired	string
data[].target_typerequired	one of: listing, seller, review
data[].targetrequired	string
data[].actionrequired	one of: dismiss, remove_content, suspend_seller, reinstate_seller
data[].reasonrequired	string
data[].actorrequired	string
data[].flags_resolvedrequired	integer	Open flags this action resolved.
data[].created_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/moderation/actions

Act on a flagged target

Resolves the target's open flags and logs who acted and why.

secret key only

POST /v1/moderation/actionsrequest

curl -X POST https://api.marketsdk.com/v1/moderation/actions \
  -H "Authorization: Bearer $MARKETSDK_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"target":"string","action":"dismiss","reason":"string","actor":"string"}'

201 example response, moderation action

{
  "object": "moderation_action",
  "id": "mod_034XtPDs7UJ0TXzTsdaHZa",
  "target_type": "listing",
  "target": "string",
  "action": "dismiss",
  "reason": "string",
  "actor": "string",
  "flags_resolved": 0,
  "created_at": "2026-10-01T12:00:00.000Z"
}

body, create moderation action

Request body
field	type	about
targetrequired	string	The listing, seller, or review acted on.
actionrequired	one of: dismiss, remove_content, suspend_seller, reinstate_seller	`dismiss` closes the open flags and changes nothing else. `remove_content` removes a listing or a review; a removed review stops counting toward reputation. `suspend_seller` suspends the seller, or the seller of a listing, or a seller who wrote a review: they cannot publish or take orders, and their listings leave search. `reinstate_seller` lifts a suspension.
reasonrequired	string	Why. Kept with the action.up to 2000 characters
actorrequired	string	Who on your team took the action, for the log.up to 200 characters

returns 201, moderation action

fields

Response fields
field	type	about
objectrequired	one of: moderation_action
idrequired	string
target_typerequired	one of: listing, seller, review
targetrequired	string
actionrequired	one of: dismiss, remove_content, suspend_seller, reinstate_seller
reasonrequired	string
actorrequired	string
flags_resolvedrequired	integer	Open flags this action resolved.
created_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.