GET /v1/classifications/{id}

from metadata.sdk import configure
from metadata.sdk.entities import Classifications

configure(
    host="https://your-company.open-metadata.org/api",
    jwt_token="your-jwt-token"
)

# Get by ID
classification = Classifications.retrieve("06d90883-6be9-4f7e-9475-753f10a95e94")
print(f"{classification.fullyQualifiedName}: {classification.description}")

# Get by ID with fields
classification = Classifications.retrieve(
    "06d90883-6be9-4f7e-9475-753f10a95e94",
    fields=["owners"]
)

# Get by fully qualified name
classification = Classifications.retrieve_by_name("Certification")

# Get by name with fields
classification = Classifications.retrieve_by_name(
    "Certification",
    fields=["owners"]
)

import static org.openmetadata.sdk.fluent.Classifications.*;

// Get by ID
var classification = Classifications.retrieve("06d90883-6be9-4f7e-9475-753f10a95e94");

// Get by ID with fields
var classification = Classifications.retrieve(
    "06d90883-6be9-4f7e-9475-753f10a95e94",
    "owners"
);

// Get by fully qualified name
var classification = Classifications.retrieveByName("Certification");

// Get by name with fields
var classification = Classifications.retrieveByName("Certification", "owners");

# Get by ID
curl "{base_url}/api/v1/classifications/06d90883-6be9-4f7e-9475-753f10a95e94" \
  -H "Authorization: Bearer {access_token}"

# Get by ID with fields
curl "{base_url}/api/v1/classifications/06d90883-6be9-4f7e-9475-753f10a95e94?fields=owners" \
  -H "Authorization: Bearer {access_token}"

# Get by fully qualified name
curl "{base_url}/api/v1/classifications/name/Certification" \
  -H "Authorization: Bearer {access_token}"

# Get by name with fields
curl "{base_url}/api/v1/classifications/name/Certification?fields=owners" \
  -H "Authorization: Bearer {access_token}"

{
  "id": "06d90883-6be9-4f7e-9475-753f10a95e94",
  "name": "Certification",
  "fullyQualifiedName": "Certification",
  "description": "Certifying Data Asset will provide the users with a clear idea of...",
  "version": 0.1,
  "updatedAt": 1769982619610,
  "updatedBy": "admin",
  "deleted": false,
  "owners": [],
  "provider": "system",
  "mutuallyExclusive": true
}

GET

classifications

{id}

GET /v1/classifications/{id}

from metadata.sdk import configure
from metadata.sdk.entities import Classifications

configure(
    host="https://your-company.open-metadata.org/api",
    jwt_token="your-jwt-token"
)

# Get by ID
classification = Classifications.retrieve("06d90883-6be9-4f7e-9475-753f10a95e94")
print(f"{classification.fullyQualifiedName}: {classification.description}")

# Get by ID with fields
classification = Classifications.retrieve(
    "06d90883-6be9-4f7e-9475-753f10a95e94",
    fields=["owners"]
)

# Get by fully qualified name
classification = Classifications.retrieve_by_name("Certification")

# Get by name with fields
classification = Classifications.retrieve_by_name(
    "Certification",
    fields=["owners"]
)

import static org.openmetadata.sdk.fluent.Classifications.*;

// Get by ID
var classification = Classifications.retrieve("06d90883-6be9-4f7e-9475-753f10a95e94");

// Get by ID with fields
var classification = Classifications.retrieve(
    "06d90883-6be9-4f7e-9475-753f10a95e94",
    "owners"
);

// Get by fully qualified name
var classification = Classifications.retrieveByName("Certification");

// Get by name with fields
var classification = Classifications.retrieveByName("Certification", "owners");

# Get by ID
curl "{base_url}/api/v1/classifications/06d90883-6be9-4f7e-9475-753f10a95e94" \
  -H "Authorization: Bearer {access_token}"

# Get by ID with fields
curl "{base_url}/api/v1/classifications/06d90883-6be9-4f7e-9475-753f10a95e94?fields=owners" \
  -H "Authorization: Bearer {access_token}"

# Get by fully qualified name
curl "{base_url}/api/v1/classifications/name/Certification" \
  -H "Authorization: Bearer {access_token}"

# Get by name with fields
curl "{base_url}/api/v1/classifications/name/Certification?fields=owners" \
  -H "Authorization: Bearer {access_token}"

{
  "id": "06d90883-6be9-4f7e-9475-753f10a95e94",
  "name": "Certification",
  "fullyQualifiedName": "Certification",
  "description": "Certifying Data Asset will provide the users with a clear idea of...",
  "version": 0.1,
  "updatedAt": 1769982619610,
  "updatedBy": "admin",
  "deleted": false,
  "owners": [],
  "provider": "system",
  "mutuallyExclusive": true
}

Retrieve a Classification

Get a single classification by its unique ID or fully qualified name.

Get by ID

string

required

UUID of the classification to retrieve.

fields

string

Comma-separated list of fields to include (e.g., owners).

include

string

default:"non-deleted"

Include all, deleted, or non-deleted entities.

Get by Fully Qualified Name

Use GET /v1/classifications/name/{fqn} to retrieve by fully qualified name.

fqn

string

required

Fully qualified name of the classification (e.g., Certification).

fields

string

Comma-separated list of fields to include: owners.

include

string

default:"non-deleted"

Include all, deleted, or non-deleted entities.

GET /v1/classifications/{id}

from metadata.sdk import configure
from metadata.sdk.entities import Classifications

configure(
    host="https://your-company.open-metadata.org/api",
    jwt_token="your-jwt-token"
)

# Get by ID
classification = Classifications.retrieve("06d90883-6be9-4f7e-9475-753f10a95e94")
print(f"{classification.fullyQualifiedName}: {classification.description}")

# Get by ID with fields
classification = Classifications.retrieve(
    "06d90883-6be9-4f7e-9475-753f10a95e94",
    fields=["owners"]
)

# Get by fully qualified name
classification = Classifications.retrieve_by_name("Certification")

# Get by name with fields
classification = Classifications.retrieve_by_name(
    "Certification",
    fields=["owners"]
)

import static org.openmetadata.sdk.fluent.Classifications.*;

// Get by ID
var classification = Classifications.retrieve("06d90883-6be9-4f7e-9475-753f10a95e94");

// Get by ID with fields
var classification = Classifications.retrieve(
    "06d90883-6be9-4f7e-9475-753f10a95e94",
    "owners"
);

// Get by fully qualified name
var classification = Classifications.retrieveByName("Certification");

// Get by name with fields
var classification = Classifications.retrieveByName("Certification", "owners");

# Get by ID
curl "{base_url}/api/v1/classifications/06d90883-6be9-4f7e-9475-753f10a95e94" \
  -H "Authorization: Bearer {access_token}"

# Get by ID with fields
curl "{base_url}/api/v1/classifications/06d90883-6be9-4f7e-9475-753f10a95e94?fields=owners" \
  -H "Authorization: Bearer {access_token}"

# Get by fully qualified name
curl "{base_url}/api/v1/classifications/name/Certification" \
  -H "Authorization: Bearer {access_token}"

# Get by name with fields
curl "{base_url}/api/v1/classifications/name/Certification?fields=owners" \
  -H "Authorization: Bearer {access_token}"

{
  "id": "06d90883-6be9-4f7e-9475-753f10a95e94",
  "name": "Certification",
  "fullyQualifiedName": "Certification",
  "description": "Certifying Data Asset will provide the users with a clear idea of...",
  "version": 0.1,
  "updatedAt": 1769982619610,
  "updatedBy": "admin",
  "deleted": false,
  "owners": [],
  "provider": "system",
  "mutuallyExclusive": true
}

Returns

Returns a classification object with all requested fields populated.

Response

string

Unique identifier for the classification (UUID format).

name

string

Classification name.

fullyQualifiedName

string

Fully qualified name of the classification.

displayName

string

Human-readable display name.

description

string

Description of the classification in Markdown format.

mutuallyExclusive

boolean

Whether tags in this classification are mutually exclusive.

provider

string

Provider: user or system.

owners

array

List of owners. Only included when fields contains owners.

version

number

Version number for the entity.

Error Handling

Code	Error Type	Description
`401`	`UNAUTHORIZED`	Invalid or missing authentication token
`403`	`FORBIDDEN`	User lacks permission to view this classification
`404`	`NOT_FOUND`	Classification with given ID or FQN does not exist

List Classifications

Update a Classification

​Retrieve a Classification

​Get by ID

​Get by Fully Qualified Name

​Returns

​Response

​Error Handling

Retrieve a Classification

Get by ID

Get by Fully Qualified Name

Returns

Response

Error Handling