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.

string

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

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.

string

required

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

string

Comma-separated list of fields to include: owners.

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).

string

Classification name.

string

Fully qualified name of the classification.

string

Human-readable display name.

string

Description of the classification in Markdown format.

boolean

Whether tags in this classification are mutually exclusive.

string

Provider: user or system.

array

List of owners. Only included when fields contains owners.

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

API Reference

Data Assets

AI SDK

SDK

Discovery

Lineage

Data Contracts

Teams And Users

Data Governance

Data Quality

Main Concepts

Retrieve 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

Retrieve a Classification

Get by ID

Get by Fully Qualified Name

Returns

Response

Error Handling