---
title: "Retrieve a custom attribute definition."
method: GET
path: "/api/v1/attributes/definitions/{definitionUid}"
tags: ["Attribute"]
---

# Retrieve a custom attribute definition.

`GET /api/v1/attributes/definitions/{definitionUid}`

## Request

- Base URL: `https://go.outseta.com`
- URL: `https://go.outseta.com/api/v1/attributes/definitions/{definitionUid}`
- Auth: none declared

The entityType segment of the URL must match the type the definition belongs to
(e.g. Account, Person, Deal).

## Path parameters

- `definitionUid` string, nullable, required

## Response `200`

- Definition
  - `Uid` string, nullable
  - `_objectType` string, nullable
  - `Created` string, date-time, required
  - `Updated` string, date-time, required
  - `ActivityEventData` unknown
  - `ControlType` string, nullable
  - `ControlParams` string, nullable
  - `Label` string, nullable
  - `SystemName` string, nullable
  - `EntityType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13: `0` - None, `1` - Account, `2` - Person, `3` - Deal, `4` - Case, `5` - Invoice, `6` - EmailLog, `7` - Plan, `8` - DiscountCoupon, `9` - AddOn, `10` - Task, `11` - Segment, `12` - Broadcast, `13` - Article
  - `Position` integer, nullable
  - `Hidden` boolean

## Other responses

- `400`: Invalid Uid format
- `404`: Definition not found

---

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