---
title: "Loads the pricing usage for the specified dates and tracking period."
method: GET
path: "/reports/pricing"
tags: ["reports"]
---

# Loads the pricing usage for the specified dates and tracking period.

`GET /reports/pricing`

Requires the privilege [`REPORTS_READ`](https://www.gremlin.com/docs/user-management/access-control/#privileges)

## Query parameters

- `startDate` string, date, required
- `endDate` string, date, required
- `trackingPeriod` 'Daily' | 'Weekly' | 'Monthly'

## Response `default`

default response

- PricingReport
  - `companyId` string — CompanyId for which the pricing report is generated
  - `startDate` string — Start date for the pricing report
  - `endDate` string — End date for the pricing report
  - `trackingPeriod` 'Daily' | 'Weekly' | 'Monthly' — Tracking period of targets for the pricing report which could be Daily, Weekly or Monthly
  - `usageByTrackingPeriod` PricingUsage[] — Pricing usage over the duration requested which is tracked over days, weeks or months
    - `start` string — Start date for usage which could be the start of day, week or month
    - `end` string — End date for usage which could be the end of day, week or month
    - `uniqueTargetsHost` integer — Count of unique targets of type Host tracked in the day, week or month
    - `uniqueTargetsContainer` integer — Count of unique targets of type Container tracked in the day, week or month
    - `uniqueTargetsApplication` integer — Count of unique targets of type Application tracked in the day, week or month
    - `maxActiveAgents` integer — Maximum number of active agents installed at the same time over the tracking period
    - `maxTargetableApplications` integer — Maximum number of active agents installed at the same time over the tracking period

## Other responses

- `401` — Authorization header missing or malformed. Please provide proper credentials in the authorization header.
- `403` — User requires privilege: REPORTS_READ

---

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