---
title: "Returns monthly usage statistics for all domains."
method: GET
path: "/usage/stats/monthly"
tags: ["usage"]
---

# Returns monthly usage statistics for all domains.

`GET /usage/stats/monthly`

## Request

- Base URL: `https://manager.digicertdns.com/v1`
- URL: `https://manager.digicertdns.com/v1/usage/stats/monthly`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/digicert/apis/digicert-dns/docs/usage/stats/monthly/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint returns monthly usage statistics for all domains, defaulting to data from the past six months, including the current month, when no parameters are specified.</br></br>Key features include:</br></br>- **Clear success messaging:** Returns a `200` success code with a confirmation message indicating the successful completion of the requested action.</br>- **Comprehensive data retrieval:** Returns a comprehensive monthly usage summary, providing a complete and accurate overview for seamless management and analysis.</br>- **Comprehensive error handling:** Returns `401` and `404` error codes with clear descriptions when requests fail.</br>- **Periodic filtering:** Uses the `month` and `year` parameters to filter results, enabling in-depth trend analysis, performance monitoring, and tailored reporting.

## Query parameters

- `year` integer
- `month` integer: Valid values are 1 to 12

## Response `200`

Usage statistics returned successfully.

- UsageStats[]
  - `month` string
  - `year` string
  - `totalQueries` integer

## Other responses

- `401`: Token is missing or expired.
- `404`: Resource not found.

---

[API](https://skmtc.dev/digicert/apis/digicert-dns.md) - [All operations](https://skmtc.dev/digicert/apis/digicert-dns/llms.txt) - [OpenAPI document](https://skmtc.dev/digicert/apis/digicert-dns/revisions/c74fc728cff8?raw)