---
title: "GET /atlas/v2/glossary/term/{termId}"
method: GET
path: "/atlas/v2/glossary/term/{termId}"
---

# GET /atlas/v2/glossary/term/{termId}

`GET /atlas/v2/glossary/term/{termId}`

## Request

- Base URL: `{endpoint}/datamap/api`
- URL: `{endpoint}/datamap/api/atlas/v2/glossary/term/{termId}`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `https://purview.azure.net/.default`

Get a specific glossary term by its GUID.

## Path parameters

- `termId` string, required

## Query parameters

- `api-version` string

## Response `200`

The request has succeeded.

- AtlasGlossaryTerm: The glossary term.
  - `guid` string: The GUID of the object.
  - `classifications` AtlasClassification[]: An array of classifications.
    - `attributes` object: The attributes of the struct.
    - `typeName` string: The name of the type.
    - `lastModifiedTS` string: ETag for concurrency control.
    - `entityGuid` string: The GUID of the entity.
    - `entityStatus` 'ACTIVE' | 'DELETED': Status - can be active or deleted
    - `removePropagationsOnEntityDelete` boolean: Determines if propagations will be removed on entity deletion.
    - `validityPeriods` TimeBoundary[]: An array of time boundaries indicating validity periods.
      - `endTime` string: The end of the time boundary.
      - `startTime` string: The start of the time boundary.
      - `timeZone` string: The timezone of the time boundary.
  - `longDescription` string: The long version description.
  - `name` string: The name of the glossary object.
  - `qualifiedName` string: The qualified name of the glossary object.
  - `shortDescription` string: The short version of description.
  - `lastModifiedTS` string: ETag for concurrency control.
  - `createTime` integer: The created time of the record.
  - `createdBy` string: The user who created the record.
  - `updateTime` integer: The update time of the record.
  - `updatedBy` string: The user who updated the record.
  - `abbreviation` string: The abbreviation of the term.
  - `templateName` unknown[]: The name of the template.
    - unknown
  - `anchor` AtlasGlossaryHeader: The glossary header with basic information.
    - `displayText` string: The display text.
    - `glossaryGuid` string: The GUID of the glossary.
    - `relationGuid` string: The GUID of the relationship.
  - `antonyms` AtlasRelatedTermHeader[]: An array of related term headers as antonyms.
    - `description` string: The description of the related term.
    - `displayText` string: The display text.
    - `expression` string: The expression of the term.
    - `relationGuid` string: The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER': Status for atlas term relationship
    - `steward` string: The steward of the term.
    - `termGuid` string: The GUID of the term.
  - `status` 'Draft' | 'Approved' | 'Alert' | 'Expired': Status for term
  - `nickName` string: The nick name of the term.
  - `hierarchyInfo` PurviewObjectId[]: The hierarchy information of the term.
    - `guid` string: The GUID of the object.
    - `typeName` string: The name of the type.
    - `uniqueAttributes` object: The unique attributes of the object.
    - `name` string: Name
    - `displayText` string: Display text
    - `itemPath` string: Item path
    - `resourceId` string: Resource Id
    - `properties` object: Dictionary of <any>
  - `resources` ResourceLink[]: An array of resource link for term
    - `displayName` string: Display name for url.
    - `url` string: web url. http or https
  - `contacts` object: The dictionary of contacts for terms. Key could be Expert or Steward.
  - `attributes` object: The custom attributes of the term, which is map<string,map<string,object>>. The key of the first layer map is term template name.
  - `assignedEntities` AtlasRelatedObjectId[]: An array of related object IDs.
    - `guid` string: The GUID of the object.
    - `typeName` string: The name of the type.
    - `uniqueAttributes` object: The unique attributes of the object.
    - `displayText` string: The display text.
    - `entityStatus` 'ACTIVE' | 'DELETED': Status - can be active or deleted
    - `relationshipType` string: Relationship type
    - `relationshipAttributes` AtlasStruct: Captures details of struct contents. Not instantiated directly, used only via AtlasEntity, AtlasClassification.
      - `attributes` object: The attributes of the struct.
      - `typeName` string: The name of the type.
      - `lastModifiedTS` string: ETag for concurrency control.
    - `relationshipGuid` string, uuid: Universally Unique Identifier
    - `relationshipStatus` 'ACTIVE' | 'DELETED': Status for atlas relationship
  - `categories` AtlasTermCategorizationHeader[]: An array of term categorization headers.
    - `categoryGuid` string, uuid: Universally Unique Identifier
    - `description` string: The description of the record.
    - `displayText` string: The display text.
    - `relationGuid` string, uuid: Universally Unique Identifier
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER': Status for atlas term relationship
  - `classifies` AtlasRelatedTermHeader[]: An array of related term headers.
    - `description` string: The description of the related term.
    - `displayText` string: The display text.
    - `expression` string: The expression of the term.
    - `relationGuid` string: The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER': Status for atlas term relationship
    - `steward` string: The steward of the term.
    - `termGuid` string: The GUID of the term.
  - `examples` string[]: An array of examples.
  - `isA` AtlasRelatedTermHeader[]: An array of related term headers indicating the is-a relationship.
    - `description` string: The description of the related term.
    - `displayText` string: The display text.
    - `expression` string: The expression of the term.
    - `relationGuid` string: The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER': Status for atlas term relationship
    - `steward` string: The steward of the term.
    - `termGuid` string: The GUID of the term.
  - `preferredTerms` AtlasRelatedTermHeader[]: An array of preferred related term headers.
    - `description` string: The description of the related term.
    - `displayText` string: The display text.
    - `expression` string: The expression of the term.
    - `relationGuid` string: The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER': Status for atlas term relationship
    - `steward` string: The steward of the term.
    - `termGuid` string: The GUID of the term.
  - `preferredToTerms` AtlasRelatedTermHeader[]: An array of related term headers that are preferred to.
    - `description` string: The description of the related term.
    - `displayText` string: The display text.
    - `expression` string: The expression of the term.
    - `relationGuid` string: The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER': Status for atlas term relationship
    - `steward` string: The steward of the term.
    - `termGuid` string: The GUID of the term.
  - `replacedBy` AtlasRelatedTermHeader[]: An array of related term headers that are replaced by.
    - `description` string: The description of the related term.
    - `displayText` string: The display text.
    - `expression` string: The expression of the term.
    - `relationGuid` string: The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER': Status for atlas term relationship
    - `steward` string: The steward of the term.
    - `termGuid` string: The GUID of the term.
  - `replacementTerms` AtlasRelatedTermHeader[]: An array of related term headers for replacement.
    - `description` string: The description of the related term.
    - `displayText` string: The display text.
    - `expression` string: The expression of the term.
    - `relationGuid` string: The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER': Status for atlas term relationship
    - `steward` string: The steward of the term.
    - `termGuid` string: The GUID of the term.
  - `seeAlso` AtlasRelatedTermHeader[]: An array of related term headers for see also.
    - `description` string: The description of the related term.
    - `displayText` string: The display text.
    - `expression` string: The expression of the term.
    - `relationGuid` string: The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER': Status for atlas term relationship
    - `steward` string: The steward of the term.
    - `termGuid` string: The GUID of the term.
  - `synonyms` AtlasRelatedTermHeader[]: An array of related term headers as synonyms.
    - `description` string: The description of the related term.
    - `displayText` string: The display text.
    - `expression` string: The expression of the term.
    - `relationGuid` string: The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER': Status for atlas term relationship
    - `steward` string: The steward of the term.
    - `termGuid` string: The GUID of the term.
  - `translatedTerms` AtlasRelatedTermHeader[]: An array of translated related term headers.
    - `description` string: The description of the related term.
    - `displayText` string: The display text.
    - `expression` string: The expression of the term.
    - `relationGuid` string: The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER': Status for atlas term relationship
    - `steward` string: The steward of the term.
    - `termGuid` string: The GUID of the term.
  - `translationTerms` AtlasRelatedTermHeader[]: An array of related term headers for translation.
    - `description` string: The description of the related term.
    - `displayText` string: The display text.
    - `expression` string: The expression of the term.
    - `relationGuid` string: The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER': Status for atlas term relationship
    - `steward` string: The steward of the term.
    - `termGuid` string: The GUID of the term.
  - `usage` string: The usage of the term.
  - `validValues` AtlasRelatedTermHeader[]: An array of related term headers as valid values.
    - `description` string: The description of the related term.
    - `displayText` string: The display text.
    - `expression` string: The expression of the term.
    - `relationGuid` string: The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER': Status for atlas term relationship
    - `steward` string: The steward of the term.
    - `termGuid` string: The GUID of the term.
  - `validValuesFor` AtlasRelatedTermHeader[]: An array of related term headers as valid values for other records.
    - `description` string: The description of the related term.
    - `displayText` string: The display text.
    - `expression` string: The expression of the term.
    - `relationGuid` string: The GUID of the relationship.
    - `status` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER': Status for atlas term relationship
    - `steward` string: The steward of the term.
    - `termGuid` string: The GUID of the term.

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-07-13** (2023-09-01) `5afce6b3aae1`: 1 info
  - api tag `Glossary` added

[Operation history](https://skmtc.dev/azure/apis/purview-datamap/changes/atlas/v2/glossary/term/:termId/get.md)

---

[API](https://skmtc.dev/azure/apis/purview-datamap.md) - [All operations](https://skmtc.dev/azure/apis/purview-datamap/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/purview-datamap/revisions/442226cb14a9?raw)
