---
title: "Returns the capacity of the specified user."
method: GET
path: "/users/{userId}/capacity"
tags: ["userCapacities"]
---

# Returns the capacity of the specified user.

`GET /users/{userId}/capacity`

Returns the capacity of the specified user.
            User planning data or admin permissions are required if the capacity of the specified user
            does not belong to the calling user.

<Check title="Required Permissions" icon="key">Any authenticated user.</Check>

## Path parameters

- `userId` string, uuid, required

## Headers

- `Authorization` string, required

## Response `200`

OK

- UserCapacity — The user capacity model.
  - `userId` string, uuid — The id of the user this capacity belongs to.
  - `weeklyCapacity` UserWeeklyCapacity
    - `mon` integer — The user's capacity on Monday, in seconds.
    - `tue` integer — The user's capacity on Tuesday, in seconds.
    - `wed` integer — The user's capacity on Wednesday, in seconds.
    - `thu` integer — The user's capacity on Thursday, in seconds.
    - `fri` integer — The user's capacity on Friday, in seconds.
    - `sat` integer — The user's capacity on Saturday, in seconds.
    - `sun` integer — The user's capacity on Sunday, in seconds.
  - `createdOn` string, date-time — The date this user capacity was created.
  - `createdBy` string, uuid — The id of the user who created this user capacity.
  - `updatedOn` string, date-time — The date when this user capacity was last updated.
  - `updatedBy` string, uuid — The id of the user who updated the user capacity.
  - `capacityPerWeek` integer — The capacity of the user per week, in seconds.

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/awork-io/apis/api-v1-reference.md) · [All operations](https://skmtc.net/awork-io/apis/api-v1-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/awork-io/api-v1-reference/versions/f784a53f60df/schema)