# Get reviews for providers

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.

Endpoint: GET /v1/providers/reviews
Version: 1.182
Security: ClientCredentialsFlow, AuthorizationCodeFlow

## Security:

  - `ClientCredentialsFlow` (unknown)
    oauth2

  - `AuthorizationCodeFlow` (unknown)
    oauth2

## Query parameters:

  - `provider_ids` (string, required)
    A comma-delimited list of Zocdoc provider IDs to fetch review counts and average ratings for. Duplicate IDs are collapsed; a maximum of 100 distinct items will be accepted at a time. IDs that are unknown or not accessible to the caller are returned with zero reviews and null ratings (not an error).

## Response 200:

  - `200` (unknown)
    Success

## Response 200 fields (application/json):

  - `request_id` (string, required)
    Unique request identifier for tracing

  - `data` (array, required)
    One item for each distinct requested provider_id, in request order.

  - `data.provider_id` (string, required)
    The Zocdoc provider ID

  - `data.total_reviews` (integer, required)
    Total number of reviews for the provider

  - `data.average_overall_rating` (number)
    The average overall rating of the provider (1-5), rounded to 1 decimal place

  - `data.average_bedside_rating` (number)
    The average bedside rating of the provider (1-5), rounded to 1 decimal place

  - `data.average_wait_time_rating` (number)
    The average wait time rating of the provider (1-5), rounded to 1 decimal place

## Response 400:

  - `400` (unknown)
    Invalid request parameters.

## Response 400 fields (application/json):

  - `request_id` (string, required)
    Unique request identifier for tracing

  - `error_type` (string, required)
    Enum: "api_error", "invalid_request"

  - `errors` (array, required)

  - `errors.field` (string)

  - `errors.message` (string, required)

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 403:

  - `403` (unknown)
    Forbidden