---
title: "Get reviews for providers"
method: GET
path: "/v1/providers/reviews"
tags: ["reviews"]
---

# Get reviews for providers

`GET /v1/providers/reviews`

## Request

- Base URL: `https://api-developer-sandbox.zocdoc.com`
- URL: `https://api-developer-sandbox.zocdoc.com/v1/providers/reviews`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://auth.zocdoc.com/oauth/token`
  - OAuth 2
    - Authorization code: `https://auth.zocdoc.com/authorize`
    - Token URL: `https://auth.zocdoc.com/oauth/token`

Get review counts and average ratings for up to 100 providers in a
single call, by their Zocdoc provider IDs. Returns numeric values only:
`total_reviews`, and average overall, bedside, and wait time ratings on
a 1-5 scale rounded to 1 decimal place. Review text is not returned.

Duplicate IDs are collapsed; returns one item per distinct requested ID,
in request order. Providers that are unknown or not accessible to the
caller are returned with zero/null ratings.

## Query parameters

- `provider_ids` string, required

## Response `200`

Success

- ProviderReviewsBatchResponse
  - `request_id` string, required: Unique request identifier for tracing
  - `data` ProviderReviewsData[], required: One item for each distinct requested provider_id, in request order.
    - `provider_id` string, required: The Zocdoc provider ID
    - `total_reviews` integer, required: Total number of reviews for the provider
    - `average_overall_rating` number, double: The average overall rating of the provider (1-5), rounded to 1 decimal place
    - `average_bedside_rating` number, double: The average bedside rating of the provider (1-5), rounded to 1 decimal place
    - `average_wait_time_rating` number, double: The average wait time rating of the provider (1-5), rounded to 1 decimal place

## Other responses

- `400`: Invalid request parameters.
- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/zocdoc/apis/zocdoc-bundle-api.md) - [All operations](https://skmtc.dev/zocdoc/apis/zocdoc-bundle-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zocdoc/apis/zocdoc-bundle-api/revisions/965a6ca4ed12?raw)