# Domains API Usage (https://developer.godaddy.com/en/docs/references/rest/domains/v2/domains-api-usage)

---
title: Domains API Usage
description: >-
  Retrieve monthly API request usage counts for your account. Data is retained
  for three months.
full: true
---

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

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

Returns monthly API request counts for the account. Data is retained for three months.

### Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `yyyymm` | string | yes | The year/month timeframe for the request counts (in the format yyyy-mm) |

### Query parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `includes` | array | no | Determines if the detail records (grouped by request path) are included in the response |

### Header parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `X-Request-Id` | string | no | A client provided identifier for tracking this request. |

### Responses

**200** — Request was successful

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/UsageMonthly`

**401** — Authentication info not sent or invalid

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/Error`

**403** — Authenticated user is not allowed access

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/Error`

**429** — Too many requests received within interval

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorLimit`

**500** — Internal server error

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/Error`

**Security:** requires `bearerAuth`.