---
title: "Get provider rankings"
method: GET
path: "/Metrics/provider-rankings"
tags: ["Metrics"]
---

# Get provider rankings

`GET /Metrics/provider-rankings`

## Request

- Base URL: `https://api.clinicos.vet/backend/business`
- URL: `https://api.clinicos.vet/backend/business/Metrics/provider-rankings`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/docs/Metrics/provider-rankings/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `period` string
- `limit` union
  - integer
  - string, int32

## Response `200`

OK

- BusinessMetricsResponseDtoOfProviderRankingsDto
  - `success` boolean
  - `data` ProviderRankingsDto
    - `rankings` ProviderRankDto[]
      - `name` string
      - `value` union
        - number, double
        - string, double
      - `rank` union
        - integer
        - string, int32
      - `change` union: Period-over-period movement; not currently computed, so null.
        - number, double
        - string, double
    - `period` string
  - `error` string, nullable
  - `message` string, nullable

## Other responses

- `500`: Internal Server Error

## Changes

- **2026-09-17** `d4ae30be0619`: 3 breaking
  - the response property `data/oneOf[#/components/schemas/ProviderRankingsDto]/rankings/items/change` became nullable for the status `200` (media type: text/plain)
  - the response property `data/oneOf[#/components/schemas/ProviderRankingsDto]/rankings/items/change` became nullable for the status `200` (media type: application/json)
  - the response property `data/oneOf[#/components/schemas/ProviderRankingsDto]/rankings/items/change` became nullable for the status `200` (media type: text/json)

[Operation history](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/changes/Metrics/provider-rankings/get.md)

---

[API](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1.md) - [All operations](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/revisions/099cf36186e0?raw)
