---
title: "Retrieve api usage request counts for a specific year/month.  The data is retained for a period of three months."
method: GET
path: "/v2/domains/usage/{yyyymm}"
tags: ["Domains"]
---

# Retrieve api usage request counts for a specific year/month.  The data is retained for a period of three months.

`GET /v2/domains/usage/{yyyymm}`

## Path parameters

- `yyyymm` string, required

## Query parameters

- `includes` string[]

## Headers

- `X-Request-Id` string

## Response `200`

Request was successful

- UsageMonthly
  - `details` UsageMonthlyDetail[] — List of total request counts per endpoint.
    - `path` string, required — The api path for the requests
    - `total` integer, required — The total number of requests in the month for the request path.
  - `quota` integer — The total number of allowed requests in the month. See https://developer.godaddy.com/getstarted for more information on api quotas and access limits.
  - `total` integer, required — The total number of requests in the month.
  - `yyyymm` string, required — The year/month timeframe for the request counts (in the format yyyy-mm)

## Other responses

- `401` — Authentication info not sent or invalid
- `403` — Authenticated user is not allowed access
- `429` — Too many requests received within interval
- `500` — Internal server error

---

[API](https://skmtc.net/godaddy/apis/domains-api.md) · [All operations](https://skmtc.net/godaddy/apis/domains-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/godaddy/domains-api/versions/475bd0561c3c/schema)