---
title: "List grants for a user"
method: GET
path: "/user/{id}/grant"
tags: ["Role and grant"]
---

# List grants for a user

`GET /user/{id}/grant`

## Request

- Base URL: `https://api.nullplatform.com`
- URL: `https://api.nullplatform.com/user/{id}/grant`
- Auth: HTTP bearer

List all grants assigned to a user. Returns a paginated list of grants with role information.

## Path parameters

- `id` integer, required

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

The list of grants for the user.

- BulkGrantPaginatedResponse
  - `paging` object, required
    - `offset` integer, required: The start of the paging window.
    - `limit` integer, required: Maximum number of elements returned.
  - `results` BulkGrantResponse[], required
    - `id` integer, required: The unique identifier for the grant.
    - `nrn` string, required: The NRN of the resource where the role is assigned.
    - `user_id` integer, required: The ID of the user who received the grant.
    - `role_id` integer, required: The ID of the role assigned.
    - `role_slug` string: The slug of the role assigned.
    - `status` 'active' | 'pending', required: The status of the grant.

## Other responses

- `404`: User not found.
- `4XX`: The request couldn't be processed. For example, a parameter is invalid, the resource doesn't exist, or you don't have permission. The body is a problem details object (RFC 9457).
- `5XX`: Something went wrong on nullplatform's side. The body is a problem details object (RFC 9457).

## Changes

- **2026-10-15** `728d4df70ca1`: 6 breaking, 15 info
  - the response property `message` became optional for the status `4XX`
  - the response property `message` became optional for the status `5XX`
  - removed the required property `error` from the response with the `4XX` status
  - removed the required property `error` from the response with the `5XX` status
  - …17 more
- **2026-09-17** `43b3c1ecdfd8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nullplatform/apis/nullplatform-api/changes/user/:id/grant/get.md)

---

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