---
title: "List user attributes"
method: GET
path: "/v1/user-attributes"
tags: ["User attributes"]
---

# List user attributes

`GET /v1/user-attributes`

<Note>
  **Organization Admin** permissions are required to use this endpoint.
</Note>

Retrieve all [user attribute](/administration/users/attributes) definitions in your organization, including both custom-defined and system-defined attributes.

User attributes enable row-level security filtering, personalize dashboard content, and configure per-user database credentials. This endpoint is useful for embed integrations to discover available attributes for setting values in SSO sessions.

## Response `200`

List of user attribute definitions

- object
  - `records` object[]
    - `id` string — The unique identifier of the user attribute. This will be an empty string for system attributes.
    - `name` string — The attribute reference name used in modeling and API calls
    - `label` string — The human-readable display name for the attribute
    - `type` 'String' | 'Number' — The data type of the attribute
    - `multiple_values` boolean — Whether the attribute accepts multiple values
    - `default_value` string, nullable — The default value for the attribute if not specified for a user
    - `description` string, nullable — Optional description of the attribute's purpose
    - `system` boolean — Whether this is a system-defined attribute (`true`) or custom attribute (`false`)

## Other responses

- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - User does not have required admin permissions
- `405` — Method Not Allowed - Invalid HTTP method for this endpoint
- `429` — Too Many Requests - Rate limit exceeded (60 requests/minute)
- `500` — Internal Server Error

---

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