---
title: "Get user's monthly usage by ID"
method: GET
path: "/v2/users/{userId}/usage/monthly"
tags: ["Users/Usage"]
---

# Get user's monthly usage by ID

`GET /v2/users/{userId}/usage/monthly`

## Request

- Base URL: `https://api.apify.com`
- URL: `https://api.apify.com/v2/users/{userId}/usage/monthly`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `token`

Returns the same summary of monthly usage as [Get user's monthly usage](/api/v2/users-me-usage-monthly-get),
for an account given by its ID or username.

You can only access your own account, or the organization your API token belongs to. API tokens with
limited permissions can't use this endpoint.

Using the `date` parameter will show the usage in the monthly usage cycle that
includes that date.

## Path parameters

- `userId` string, required

## Query parameters

- `date` string

## Response `200`

- MonthlyUsageResponse
  - `data` MonthlyUsage, required
    - `usageCycle` UsageCycle, required
      - `startAt` string, date-time, required
      - `endAt` string, date-time, required
    - `monthlyServiceUsage` MonthlyServiceUsage, required: A map of usage item names (e.g., ACTOR_COMPUTE_UNITS) to their usage details.
    - `dailyServiceUsages` DailyServiceUsage[], required
      - `date` string, date-time, required
      - `serviceUsage` ServiceUsage, required: A map of service usage item names to their usage details.
      - `totalUsageCreditsUsd` number, required
    - `totalUsageCreditsUsdBeforeVolumeDiscount` number, required
    - `totalUsageCreditsUsdAfterVolumeDiscount` number, required

## Other responses

- `400`: Bad request - invalid input parameters or request body.
- `401`: Unauthorized - authentication required or invalid token.
- `403`: Forbidden - insufficient permissions to perform this action.
- `404`: Not found - the requested resource does not exist.
- `405`: Method not allowed.
- `429`: Too many requests - rate limit exceeded.

## Changes

> 25 revisions in range; 1 not diffed.

- **2026-10-27** `ec76185eb934`: 6 info
  - added the optional property `error/data` to the response with the `400` status
  - added the optional property `error/data` to the response with the `401` status
  - added the optional property `error/data` to the response with the `403` status
  - added the optional property `error/data` to the response with the `404` status
  - …2 more
- **2026-10-27** `e52dd2239cee`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/apify/apis/apify-api/changes/v2/users/:userId/usage/monthly/get.md)

---

[API](https://skmtc.dev/apify/apis/apify-api.md) - [All operations](https://skmtc.dev/apify/apis/apify-api/llms.txt) - [OpenAPI document](https://skmtc.dev/apify/apis/apify-api/revisions/68d2d102e6a2?raw)