---
title: "List user grants"
method: GET
path: "/v3/users/{userId}/grants"
tags: ["Grants"]
---

# List user grants

`GET /v3/users/{userId}/grants`

Retrieves a list of user grants.

## Path parameters

- `userId` string, required

## Query parameters

- `active` boolean

## Response `200`

Returns a list of grants for the user

- union
  - GrantsResponse
    - `results` GrantResponse[]
      - `grantId` string
      - `user_id` string
      - `account_id` string
      - `expiry_state` 'pending' | 'active' | 'expired'
      - `entitlement_type` 'bundle' | 'entitlement' | 'meter' | 'credits' — An enum describing the type of the entitlement.
      - `entitlement_id` string
      - `startTime` string
      - `endTime` string
      - `product_id` string
      - `createdAt` string
  - GrantResponse[]
    - `grantId` string
    - `user_id` string
    - `account_id` string
    - `expiry_state` 'pending' | 'active' | 'expired'
    - `entitlement_type` 'bundle' | 'entitlement' | 'meter' | 'credits' — An enum describing the type of the entitlement.
    - `entitlement_id` string
    - `startTime` string
    - `endTime` string
    - `product_id` string
    - `createdAt` string

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/zuora/apis/admin-api-reference.md) · [All operations](https://skmtc.net/zuora/apis/admin-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zuora/admin-api-reference/revisions/789812d35ac8/schema)