---
title: "Get user permissions"
method: GET
path: "/api/v2/organizations/users/{user_id}/permissions"
tags: ["Orgs"]
---

# Get user permissions

`GET /api/v2/organizations/users/{user_id}/permissions`

## Request

- Base URL: `https://api.kiloiot.io`
- URL: `https://api.kiloiot.io/api/v2/organizations/users/{user_id}/permissions`
- Auth: API key in header `X-API-Key` and API key in header `X-Organization-Id`

Retrieve a user's role and permissions within the organization.

**Required scope:** `orgs:read`

## Path parameters

- `user_id` string, required

## Query parameters

- `organizationId` string, required

## Response `200`

OK

- object[]
  - `action` 'read' | 'write'
  - `object_code` integer
  - `object_text_code` string
  - `object_title` string

## Other responses

- `401`: Missing or invalid API key
- `403`: Insufficient permissions (missing required scope)

---

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