---
title: "Get completion rate stats from your businesses"
method: GET
path: "/business/search/stats"
tags: ["Businesses"]
---

# Get completion rate stats from your businesses

`GET /business/search/stats`

This endpoint works in the same way as the [operation/searchBusinesses](/api-reference/businesses/search-for-businesses) endpoint, but instead of returning data on all returned businesses, this endpoint returns completion rate statistics aggregated across all businesses.

The statistics returned are the average completion rate for all businesses that fit the given filters, as well as the count of businesses with a low, medium, and high respectively. The thresholds for low, medium, and high can be found below in the response details.

Note that this endpoint works in the exact same way as [operation/searchBusinesses](/api-reference/businesses/search-for-businesses) (with the exception of parameters that format the output, such as `order_by` and pagination), but the return value is different.

## Query parameters

- `query` string
- `business__in` BusinessId[]
- `org_id` integer
- `groups` integer[]
- `country` string
- `name` string
- `status` 'open' | 'closed' | 'opening_soon' | 'closed_temporarily' — Defines the current status of the business. - `Open` indicates the business is up and running. - `Closed` means that the business has definitely closed. - `Opening Soon` indicates the business is open with an opening date set in the future. - `Temporarily closed` means that the business is temporarily closed. ⚠️ To get all businesses with the status `open`, regardless of whether the `opening_date` has passed yet or not, submit both the `open` and `opening_soon` options in the filter: `status=open,opening_soon`.
- `zipcode` string
- `city` string
- `code` string
- `modified__gte` number
- `features__in` 'diffusion' | 'feedback_management' | 'messages' | 'posts' | 'review_invite' | 'review_management'
- `features__notin` 'diffusion' | 'feedback_management' | 'messages' | 'posts' | 'review_invite' | 'review_management'
- `subscribed_to_rm` boolean
- `subscribed_to_pm` boolean
- `subscribed_to_rb` boolean
- `subscribed_to_bm` boolean
- `completion_rate__gte` integer
- `completion_rate__lte` integer
- `completion_rate` 'low' | 'mid' | 'high'
- `has_promo` boolean
- `connected_to_gmb_location` boolean
- `connected_to_facebook_location` boolean

## Response `200`

OK

- object
  - `average_completion_rate` integer — The average completion rate of all businesses that fit the filters given in paramers.
  - `counts` object
    - `low` integer — The number of businesses that fit the filters given in paramers with a completion score of <=33.
    - `mid` integer — The number of businesses that fit the filters given in paramers with a completion score of >33 and <=66.
    - `high` integer — The number of businesses that fit the filters given in paramers with a completion score of >66.

## Other responses

- `400` — Your request is incorrect
- `401` — You are not authenticated

---

[API](https://skmtc.net/partoo/apis/partoo-rest-api.md) · [All operations](https://skmtc.net/partoo/apis/partoo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/partoo/partoo-rest-api/revisions/3652d8b1a8b3/schema)