Your reviews — API reference
How to read your buyer reviews and post seller responses using the Herpify Breeder API.
What it does
The reviews endpoints let you read all the reviews you've received from buyers and post public responses to individual reviews. Only approved reviews are returned — reviews under moderation won't appear.
Who can access it
Breeder plan subscribers only. Authenticate with your API key in the `Authorization: Bearer` header.
List your reviews — GET /api/breeder/reviews
Returns a paginated list of approved reviews received by your account, newest first.
| Parameter | Type | Required | Description |
|---|---|---|---|
| rating | number | Optional | Filter by star rating: 1, 2, 3, 4, or 5. Leave blank to see all ratings. |
| limit | number | Optional | How many reviews per page. Between 1 and 100. Default is 20. |
| cursor | string | Optional | Pagination cursor from `meta.nextCursor`. |
Respond to a review — POST /api/breeder/reviews/:id/respond
Posts a public seller response to a review. Your response appears below the review on your profile. You can update it as many times as you like by calling the same endpoint again.
| Parameter | Type | Required | Description |
|---|---|---|---|
| response | string | Required | Your reply to the review. Minimum 10 characters, maximum 1,000 characters. |
Example response — review list
{
"data": [
{
"id": "clxg7h8i9j0k1l2m3",
"rating": 5,
"comment": "Absolute legend! Animal arrived in perfect condition, packaged beautifully and exactly as described. Will definitely buy again.",
"sellerResponse": null,
"respondedAt": null,
"reviewer": { "displayName": "Sarah M.", "avatarUrl": null },
"listing": {
"id": "clxa1b2c3d4e5f6g7",
"title": "Banana Pastel Clown Ball Python"
},
"createdAt": "2026-03-15T09:22:00.000Z"
}
],
"meta": { "limit": 20, "hasMore": false, "nextCursor": null }
}Real-world example
You want to respond to every 5-star review within 24 hours to build a strong reputation. A script runs each morning, pulls reviews where `sellerResponse` is null and `rating` is 5, and flags them for your attention in Slack or email. You write the response, and your script POSTs it automatically. Consistent, professional responses — without remembering to check manually.
Was this article helpful?
