RedRover Logo

Agency Partners

List a Client's Comments

Lists one client's comments, like List Comments with X-Workspace-Id.

GET/clients/{client}/comments
Scope: comments:read

Needs a partner key; any other key or a connected AI app gets 403.

Headers

  • AuthorizationstringRequired

    Bearer followed by an rr_live_ API key or a connected app's access token. See Authentication.

Path Parameters

  • clientstringRequired

    The client's workspace ID, or your own reference for it. A UUID is tried as an ID first

Query Parameters

  • limitinteger

    How many results to return, 1 to 100 (default 25)

    1 to 100 · default 25

  • offsetinteger

    How many results to skip (default 0)

    default 0

  • statusstring

    Only return content with this status

    one of draft, pending_approval, scheduled, posted, failed, cancelled

Response

200 A page of comments.

  • dataobject[]Required
    Show 15 Child Fields
    • idstringRequired

      Content ID. Content waiting for your approval has a UUID; scheduled content has a number

    • typestringRequired

      post or comment

      one of post, comment

    • statusstringRequired

      Where it stands

      one of draft, pending_approval, approved, scheduled, posted, failed, cancelled

    • titlestringRequired

      Post title. Null for comments

      nullable

    • bodystringRequired

      The text

      nullable

    • subredditstringRequired

      Subreddit, without r/

      nullable

    • flairstringRequired

      Post flair. Posts only

      nullable

    • threadUrlstringRequired

      Comments only: the thread the comment replies in

      nullable

    • scheduledForstringRequired

      When it is due to go live

      nullable

    • postedAtstringRequired

      When it went live

      nullable

    • urlstringRequired

      The live link once posted

      nullable

    • upvotesnumberRequired

      Upvotes once posted

      nullable

    • commentCountnumberRequired

      Replies once posted

      nullable

    • failureReasonstringRequired

      Why it failed or was removed, when it did

      nullable

    • canChangebooleanRequired

      Whether you can still edit, reschedule or cancel it

  • paginationobjectRequired
    Show 3 Child Fields
    • limitintegerRequired

      Page size used for this response

    • offsetintegerRequired

      How many results were skipped

    • hasMorebooleanRequired

      True when more results follow at a higher offset

Errors

Every error uses the error envelope.

  • 404No client with this ID or reference in your agency
  • 401The Authorization header is missing, or the key is invalid or revoked
  • 403The key lacks the endpoint's scope, or cannot reach the workspace
  • 429More than 120 requests in a minute. Wait for Retry-After seconds
  • 500Something went wrong on our side
curl "https://app.tryredrover.com/api/public/v1/clients/crm-1042/comments?status=scheduled" \
  -H "Authorization: Bearer $REDROVER_API_KEY"
200 Response
{
  "data": [
    {
      "id": "91574",
      "type": "comment",
      "status": "scheduled",
      "title": null,
      "body": "We batch ours on Thursdays and ship Friday morning. Keeps it honest.",
      "subreddit": "startups",
      "flair": null,
      "threadUrl": "https://www.reddit.com/r/startups/comments/1abcde2/how_do_you_plan_content/",
      "scheduledFor": "2026-12-01T15:00:00Z",
      "postedAt": null,
      "url": null,
      "upvotes": null,
      "commentCount": null,
      "failureReason": null,
      "canChange": true
    }
  ],
  "pagination": {
    "limit": 25,
    "offset": 0,
    "hasMore": false
  }
}