List reviews

Reviews · GET /v1/reviews

List reviews

GET/v1/reviews

Request

curl https://api.repull.dev/v1/reviews?limit=20 \
  -H "Authorization: Bearer $REPULL_API_KEY"

Response

{
  "data": [
    {
      "id": "123",
      "externalId": "123",
      "platform": "booking",
      "listingId": "123",
      "reservationId": "123",
      "reservationConfirmationCode": "Example text",
      "guestId": "123",
      "guestName": "Example",
      "guestAvatar": null,
      "reviewerRole": "Example text",
      "rating": 0,
      "categories": [
        {
          "category": "facilities",
          "rating": 0,
          "comment": null
        }
      ],
      "publicReview": "Example text",
      "privateFeedback": null,
      "isRevieweeRecommended": null,
      "response": null,
      "submittedAt": "Example text",
      "updatedAt": "Example text",
      "expiresAt": null,
      "hidden": false,
      "language": null,
      "providerPropertyId": "123"
    }
  ],
  "pagination": {
    "nextCursor": "eyJpZCI6MTIzfQ==",
    "hasMore": true,
    "total": 0
  }
}

Captured from a real response. Regenerated on every release, and CI fails if this shape stops matching the API.

Query Parameters

accountstring

Only one connected account's records, as `provider:externalAccountId` (e.g. `airbnb:79730216`, `booking:10167991`, `vrbo:36`, `hostaway:…`) — the pair on every webhook `account` block, on `connect.session.completed`, and on each record's `account`. See /for-platforms.

cursorstring

Opaque cursor returned in the previous response's `pagination.nextCursor`.

offsetinteger

First-class alias for cursor-based pagination. Mutually exclusive with `cursor` — passing both returns 422. Accepts integers in `[0, 10000]`; deeper walks must use `cursor` (constant per-page cost). The response always includes `pagination.nextCursor` so consumers can switch from offset → cursor mid-walk for deep pagination without re-keying.

limitinteger

platformstring

listingIdinteger

Restrict to one internal Repull listing.

rating_minnumber

rating_maxnumber

statusstring

`responded` — host has replied. `unanswered` — host has not replied. `all` — no filter.

reviewerRolestring

`guest` (default) — reviews written by guests about the host/property. `host` — reviews written by the host about guests. `all` — both.

Previous← Withdraw Special Offer NextGet Review →