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

# Get user's limits by ID

`GET /v2/users/{userId}/limits`

## Request

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

Returns the same summary of limits as [Get user's limits](/api/v2/users-me-limits-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.

## Path parameters

- `userId` string, required

## Response `200`

- AccountLimitsResponse
  - `data` AccountLimits, required
    - `monthlyUsageCycle` UsageCycle, required
      - `startAt` string, date-time, required
      - `endAt` string, date-time, required
    - `limits` Limits, required
      - `maxMonthlyUsageUsd` number, required
      - `maxMonthlyActorComputeUnits` number, required
      - `maxMonthlyExternalDataTransferGbytes` number, required
      - `maxMonthlyProxySerps` integer, required
      - `maxMonthlyResidentialProxyGbytes` number, required
      - `maxActorMemoryGbytes` number, required
      - `maxActorCount` integer, required
      - `maxActorTaskCount` integer, required
      - `maxConcurrentActorJobs` integer, required
      - `maxTeamAccountSeatCount` integer, required
      - `dataRetentionDays` integer, required
      - `maxScheduleCount` integer
      - `maxMonthlyUnblockerUnits` number
    - `current` CurrentUsage, required
      - `monthlyUsageUsd` number, required
      - `monthlyActorComputeUnits` number, required
      - `monthlyExternalDataTransferGbytes` number, required
      - `monthlyProxySerps` integer, required
      - `monthlyResidentialProxyGbytes` number, required
      - `actorMemoryGbytes` number, required
      - `actorCount` integer, required
      - `actorTaskCount` integer, required
      - `activeActorJobCount` integer, required
      - `teamAccountSeatCount` integer, required
      - `scheduleCount` integer
      - `monthlyUnblockerUnits` number

## 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/limits/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)