---
title: "Get asset attribute details"
method: GET
path: "/v1/asset-management-schema/{attribute-name}"
tags: ["Asset Management Schema"]
---

# Get asset attribute details

`GET /v1/asset-management-schema/{attribute-name}`

Retrieve a single asset attribute definition by name. Available to any authenticated user.

## Path parameters

- `attribute-name` string, required — Asset attribute name.

## Response `200`

Asset attribute details.

- AssetAttribute — Asset attribute definition (a single element of the asset management schema).
  - `name` string, required — Unique attribute name. Must match the pattern ^[A-Za-z$_][A-Za-z0-9$_]*$. Immutable after creation.
  - `displayName` string — Human-readable display name.
  - `dataType` 'String' | 'Integer' | 'Number' | 'Boolean' | 'Enum' | 'MacAddress' | 'IPAddress' | 'UUID' | 'ObjectReference' | 'Date' — Attribute data type. Accepts the symbolic name (or, for backward compatibility, the numeric code) on input; always returned as the symbolic name.
  - `isMandatory` boolean — Whether a value for this attribute is mandatory on assets.
  - `isUnique` boolean — Whether the attribute value must be unique across all assets.
  - `isHidden` boolean — Whether the attribute is hidden in the UI.
  - `autofillScript` string — NXSL script used to automatically populate the attribute value.
  - `rangeMin` integer — Minimum value (for numeric types) or minimum length (for strings). 0 means unset.
  - `rangeMax` integer — Maximum value (for numeric types) or maximum length (for strings). 0 means unset.
  - `systemType` 'None' | 'Serial' | 'IPAddress' | 'MacAddress' | 'Vendor' | 'Model' — System type binding for the attribute. Accepts the symbolic name (or the numeric code) on input; always returned as the symbolic name.
  - `enumMap` object — For the Enum data type, the map of allowed values to their display names.

## Other responses

- `400` — Invalid attribute name.
- `401` — Unauthorized.
- `404` — Asset attribute not found.

---

[API](https://skmtc.net/netxms/apis/netxms-api.md) · [All operations](https://skmtc.net/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netxms/netxms-api/versions/14d93e5115dd/schema)