---
title: "List authorization subject attributes"
method: GET
path: "/authz/subject-attributes"
tags: ["authz-subject-attributes"]
---

# List authorization subject attributes

`GET /authz/subject-attributes`

(reserved for future use) Lists authorization subject attributes for the caller's tenant (tenant\_id is derived from the authenticated user).

Required roles: All

## Query parameters

- `principal_type` string
- `limit` integer
- `offset` integer

## Response `200`

Successful retrieval of subject attributes

- ListAuthzSubjectAttributesResponse
  - `subject_attributes` AuthzSubjectAttribute[], required
    - `tenant_id` string, required — Tenant identifier (derived from the authenticated user)
    - `principal_type` string, required — Principal type (e.g. "user")
    - `principal_id` string, required — Principal identifier
    - `attributes` object, required — Free-form authorization attributes (e.g. role, grade, departments)
    - `created_at` integer, required — Unix timestamp when the record was created
    - `updated_at` integer, required — Unix timestamp when the record was last updated
  - `pagination` Pagination, required
    - `total` integer — Total number of items
    - `limit` integer, required — Maximum number of items per page
    - `has_more` boolean, required — Whether there are more items after this page
    - `next_id` string, uuid, nullable — ID to pass as after_id for next page (null if has_more=false)

## Other responses

- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/qlonolink/apis/qaip-apis.md) · [All operations](https://skmtc.net/qlonolink/apis/qaip-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qlonolink/qaip-apis/revisions/f5f5994dfe05/schema)