Get flag status

Get the current flag on a review, or a none state when the review has never been flagged.

Use it to show moderation state next to a review, or to check whether a flag you submitted has been actioned yet.

Auth

  • Both partner-level and account-level users can call it.

Rate limit

  • No rate limit.

Path params

ParameterTypeRequiredNotes
reviewIdintegerRequiredThe review's numeric id. Digits only.

Behaviour

  • 200 always returns review_id, is_flagged and flag_status.
  • When a flag exists, flag holds the full record and flag_status is one of pending, denied, approved_removed or submitted_to_platform.
  • When no flag exists, flag is null and flag_status is none. This is still a 200, not a 404 — a review with no flag is a valid result, not a missing one.

Errors

StatusMessageCause
401UnauthenticatedThe bearer token is missing, expired or invalid.
404Review not foundNo review exists with that id.
500Unexpected server error.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Response

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json