Reviews API

Reviews API

Access customer reviews and ratings for businesses on the TaskNation platform.

Get Business Reviews

GET /api/v2/business/{businessID}/reviews
Authorization: Bearer {accessToken}

# Query parameters
?sort=recent|highest|lowest
&limit=20
&offset=0

Response

{
  "reviews": [
    {
      "id": "rev_abc123",
      "rating": 5,
      "text": "Mike was fantastic! He fixed our kitchen sink quickly and the price was very fair. Highly recommend.",
      "author": "Sarah M.",
      "category": "Plumbing",
      "createdAt": "2026-01-20T16:00:00Z",
      "response": {
        "text": "Thank you Sarah! It was a pleasure working with you.",
        "createdAt": "2026-01-21T09:00:00Z"
      }
    }
  ],
  "summary": {
    "averageRating": 4.8,
    "totalReviews": 127,
    "distribution": {
      "5": 98,
      "4": 18,
      "3": 7,
      "2": 2,
      "1": 2
    }
  }
}

Respond to a Review

POST /api/v2/business/{businessID}/reviews/{reviewID}/response
Authorization: Bearer {accessToken}
Content-Type: application/json

{
  "text": "Thank you for the kind words! We appreciate your business."
}