---
id: user-grants-list
title: "List grants for a user"
description: "List all grants assigned to a user. Returns a paginated list of grants with role information."
sidebar_label: "List grants for a user"
hide_title: true
hide_table_of_contents: true
api: eJzdWG1v2zYQ/ivEfVoBzVHelk1AP2Rd12XYiiBNsAJJEJzFs82GIlW+5KWG/vtwlGTLsdOkQ9cB+6JY1PHuuedeyMscJPnSqTooa6CAP5QPArUWU4cmeIHeq6khKYIVKKInNxInFKIzXqCocaoMBpJC8z476bfdqjATzmoSykysq5DVjy4MZBBw6qE4hxP+ika2W+AyA1uTS4JHEgpgW0WrrmDtkIGnMjoV7qE4n8OY0JE7jGEGxfllc5lBjQ4rCuR8EjBYERSgJGSg2LcawwyyBw6fzkhEoz5GEkqSCWqiyImJdSLwF3YYMnD0MSpHEorgImXgyxlVCMUcwn2drJhAU3LQZEB3WNWaoDj48acmW+Cwk4mn0GP5GMndbwRjYjUmx1yqQJVn4v21qsWYJtaR8AFdUGbK66XVmsqQkDryUQfhKazinaD2nwPMECYYdYAiH4LPB9C1qtQzkFd4p6pYbfLApZT5x8h28ww67VBs5ytAd3OOvSNfW+PJs6KdPOc/6wgfZOnDKJfWBDKB92Jda1WmbNz64FnBfB2pHX+gMqw4dQ6pJqZpkSPiObNrx7kdVAuvk3hCzyJfWvbXtHTfN/P20PGUNew5u9vaF7fKSHvLfg+D3pl7Wu2fa9EmTRUxr220Sa7o3s2bplmysjSAziEnVEqWp1hJ1WwcNxKO2lV650bT/vIBQ9xAuZLPJOrxVpByZsWj7Z3dvf2mhbPU7oNr47+u/O3J2z4GjryNriRxOyNH7VJql8uWu2ILrJuiUZ9SRr7cLrAsbTTh5Q53nJ6J57l49EsPgveJ2xmXZ0nqhrv8RkdTI1uw/KVWkl8bnTrI893tg4P9H3rtXsfp86hkyacNgKQb0pwITFOXHBv0k+HGcg5YBnVDkEFNRvKny0eKKUTfW1+nq1fD6R5USEvjqK/fsORJ16ig2fj5uD9Rh3JNBnv53npLO+P4GRvExEYjR+zj3vv363KvtCITBDlnnVh0SiEjcW9W5ga1kkKZOgZhnaiU99wglufpV2uOLXWvrGSSEx7IoCLvcUrrVTuQfjrpfjs9Pe5DU1rJJVY78lzHfFpy3Goq1USVohzy8R2NpqNM7OU5P7b5scuPvRcrQd1Lp065iuWRBD0UFZYzZeh7RyhxrKmzlXCFGQZRYqCpdeoT+RYbuRtuNqh0dLSaTmOUV0wi+ZDuF4m2Z4AYO0WTTMxihWaJZCDVp3ALjtX1bFzAzyjFSWv0AnjhzGAMswRZXsAqOUNphthH9GmQUir+iVpICqi0Fzi2MSxhrdo5Ta0z2RG36EWFmq+XJEVi1wRUfFntU3qYwU3TVtL+pgp519L/sEKUkSnPzVSgEcr7SMKaBO7w+Eh4Jel/Vhp+SESXDPtcGvv5Dj92VwO//99VBTvrDOqrVuiqpeyb1cdRZ150qfOaZdpK4RVVkjgzeINKs9a1gtm4/V8tnUMjoqG7mkqe11qXbFlG50iOxLEm9CSCuxc4RWWExsCX4qYvm4rCzPJcNk2X0jRLFbDFV4ituZLNVjvG8ZDGDrUjWHQaCpiFUPtiawtrNTJR61pj4KodlbYCvrz3c907LpQ2v4fT3YIJVgTdxJAaYxKCrPvxaxo0oYDf/zpNhy/Pnryd8bSkbY/yUQ7Lc/ewa2mpYJn+2vpQYSrbbvhJE/FgYGin4IfhmC+bwLeYoVs+At2FrVqjStAT2fMuMufQoSzSvXgxY8+sD/x1Ph+jpzOnm4aX26GOQyaV54RdzmePuvnVhtWN3lzT/XBovkEdWQh4LP0yjM8aSz+DoZ9+lxAu+cUpxvCFnH130nX8F+J5/3jYiKsfnMz9EFaPV0loLpsMZoSSXALYfjgsS6qHnqwdVuzZotDfvD6FDHC1BB+UXNK+Ec583kqc2msyTbNAF/idATbN36Z+X54=
sidebar_class_name: "get api-method"
info_path: docs/api/authorization
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"List grants for a user"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/user/{id}/grant"}
  context={"endpoint"}
>
  
</MethodEndpoint>



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


<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"name":"id","in":"path","description":"The unique identifier for the user.","required":true,"schema":{"type":"integer"},"example":789},{"name":"offset","in":"query","description":"The number of items to skip before starting to collect the result set.","required":false,"schema":{"type":"integer","default":0},"example":0},{"name":"limit","in":"query","description":"The maximum number of items to return.","required":false,"schema":{"type":"integer","default":30,"maximum":100},"example":30}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The list of grants for the user.","content":{"application/json":{"schema":{"type":"object","required":["paging","results"],"properties":{"paging":{"type":"object","required":["offset","limit"],"properties":{"offset":{"type":"integer","description":"The start of the paging window.","example":0},"limit":{"type":"integer","description":"Maximum number of elements returned.","example":30}}},"results":{"type":"array","items":{"type":"object","required":["id","nrn","user_id","role_id","status"],"properties":{"id":{"type":"integer","description":"The unique identifier for the grant.","example":12345},"nrn":{"type":"string","description":"The NRN of the resource where the role is assigned.","example":"organization=1:account=2"},"user_id":{"type":"integer","description":"The ID of the user who received the grant.","example":789},"role_id":{"type":"integer","description":"The ID of the role assigned.","example":700317756},"role_slug":{"type":"string","description":"The slug of the role assigned.","example":"developer"},"status":{"type":"string","enum":["active","pending"],"description":"The status of the grant.","example":"active"}},"title":"bulkGrantResponse"}}},"title":"bulkGrantPaginatedResponse"}}}},"404":{"description":"User not found."},"4XX":{"description":"Client error responses due to invalid input or missing parameters.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific client error (e.g., 400, 401, 403, 404).","example":400},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"bad_request"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Bad Request\", \"Unauthorized\").","example":"Bad Request"},"message":{"type":"string","description":"Additional details about the error.","example":"The request was malformed or contained invalid parameters."}}}}}},"5XX":{"description":"Server error responses indicating an issue on the API side.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific server error (e.g., 500, 502, 503).","example":500},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"internal_server_error"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Internal Server Error\", \"Service Unavailable\").","example":"Internal Server Error"},"message":{"type":"string","description":"Additional details about the error.","example":"An unexpected error occurred. Please try again later."}}}}}}}}
>
  
</StatusCodes>