---
title: "Get Capacity Exceptions by User"
method: GET
path: "/v2/users/capacity/exceptions/{userID}"
tags: ["Routes", "Users", "Capacity", "Exceptions"]
---

# Get Capacity Exceptions by User

`GET /v2/users/capacity/exceptions/{userID}`

Gets capacity exception records for a specific user.

`capacityMinutes` is the user's available capacity **per day** for each date in the exception range.

Query behavior:
- `locations` scopes by user location membership.
- `startDate`/`endDate` filter by date overlap (YYYY-MM-DD).
- `cursor`/`limit` paginate results.

Response fields include:
`exceptionID`, `userID`, `createdByUserID`, `exceptionStartDate`, `exceptionEndDate`, `capacityMinutes`, `hoursPerDay`, `minutesPerDay`, `exceptionTitle`, `exceptionNotes`, `exceptionType`.

## Query parameters

- `locations` integer
- `startDate` string
- `endDate` string
- `cursor` integer
- `limit` integer

## Response `200`

Get User Capacity Exceptions

- object[]
  - `exceptionID` integer
  - `userID` integer
  - `createdByUserID` integer
  - `exceptionStartDate` string, date
  - `exceptionEndDate` string, date
  - `capacityMinutes` integer
  - `hoursPerDay` integer
  - `minutesPerDay` integer
  - `exceptionTitle` string
  - `exceptionNotes` string
  - `exceptionType` unknown

## Other responses

- `400` — The request was malformed — either invalid JSON syntax or a validation failure (missing required field, wrong type, etc.).
- `401` — No `Authorization` header was provided on the request.
- `403` — The supplied credentials are invalid, the customer account is inactive, or the credentials do not have permission to perform this action.
- `404` — The referenced resource does not exist or is not visible to the authenticated customer.
- `429` — The per-minute or per-hour rate limit for this credential and method has been exhausted. Inspect the `X-RateLimit-*` headers to determine when to retry.
- `500` — An unhandled server-side error. The body message is generic (`System unavailable...`) when the underlying cause is a database fault; otherwise it reflects the raised error.

---

[API](https://skmtc.net/limblecmms/apis/limble-api-v2.md) · [All operations](https://skmtc.net/limblecmms/apis/limble-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/limblecmms/limble-api-v2/versions/20801e23f7f2/schema)