from metadata.sdk import configurefrom metadata.sdk.entities import Classificationsconfigure( host="https://your-company.open-metadata.org/api", jwt_token="your-jwt-token")# Get by IDclassification = Classifications.retrieve("06d90883-6be9-4f7e-9475-753f10a95e94")print(f"{classification.fullyQualifiedName.root}: {getattr(classification.description, 'root', classification.description)}")# Get by ID with fieldsclassification = Classifications.retrieve( "06d90883-6be9-4f7e-9475-753f10a95e94", fields=["owners"])# Get by fully qualified nameclassification = Classifications.retrieve_by_name("Certification")# Get by name with fieldsclassification = Classifications.retrieve_by_name( "Certification", fields=["owners"])
// client is an initialized OpenMetadataClient.var classification = client.classifications().get("06d90883-6be9-4f7e-9475-753f10a95e94");// Get by ID with fieldsvar classificationWithFields = client.classifications().get( "06d90883-6be9-4f7e-9475-753f10a95e94", "owners");// Get by fully qualified namevar classificationByName = client.classifications().getByName("Certification");// Get by name with fieldsvar classificationByNameWithFields = client.classifications().getByName( "Certification", "owners");
# Get by IDcurl "{base_url}/api/v1/classifications/06d90883-6be9-4f7e-9475-753f10a95e94" \ -H "Authorization: Bearer {access_token}"# Get by ID with fieldscurl "{base_url}/api/v1/classifications/06d90883-6be9-4f7e-9475-753f10a95e94?fields=owners" \ -H "Authorization: Bearer {access_token}"# Get by fully qualified namecurl "{base_url}/api/v1/classifications/name/Certification" \ -H "Authorization: Bearer {access_token}"# Get by name with fieldscurl "{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 classification by ID or fully qualified name
GET
/
v1
/
classifications
/
{id}
GET /v1/classifications/{id}
from metadata.sdk import configurefrom metadata.sdk.entities import Classificationsconfigure( host="https://your-company.open-metadata.org/api", jwt_token="your-jwt-token")# Get by IDclassification = Classifications.retrieve("06d90883-6be9-4f7e-9475-753f10a95e94")print(f"{classification.fullyQualifiedName.root}: {getattr(classification.description, 'root', classification.description)}")# Get by ID with fieldsclassification = Classifications.retrieve( "06d90883-6be9-4f7e-9475-753f10a95e94", fields=["owners"])# Get by fully qualified nameclassification = Classifications.retrieve_by_name("Certification")# Get by name with fieldsclassification = Classifications.retrieve_by_name( "Certification", fields=["owners"])
// client is an initialized OpenMetadataClient.var classification = client.classifications().get("06d90883-6be9-4f7e-9475-753f10a95e94");// Get by ID with fieldsvar classificationWithFields = client.classifications().get( "06d90883-6be9-4f7e-9475-753f10a95e94", "owners");// Get by fully qualified namevar classificationByName = client.classifications().getByName("Certification");// Get by name with fieldsvar classificationByNameWithFields = client.classifications().getByName( "Certification", "owners");
# Get by IDcurl "{base_url}/api/v1/classifications/06d90883-6be9-4f7e-9475-753f10a95e94" \ -H "Authorization: Bearer {access_token}"# Get by ID with fieldscurl "{base_url}/api/v1/classifications/06d90883-6be9-4f7e-9475-753f10a95e94?fields=owners" \ -H "Authorization: Bearer {access_token}"# Get by fully qualified namecurl "{base_url}/api/v1/classifications/name/Certification" \ -H "Authorization: Bearer {access_token}"# Get by name with fieldscurl "{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, for example 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, for example 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 configurefrom metadata.sdk.entities import Classificationsconfigure( host="https://your-company.open-metadata.org/api", jwt_token="your-jwt-token")# Get by IDclassification = Classifications.retrieve("06d90883-6be9-4f7e-9475-753f10a95e94")print(f"{classification.fullyQualifiedName.root}: {getattr(classification.description, 'root', classification.description)}")# Get by ID with fieldsclassification = Classifications.retrieve( "06d90883-6be9-4f7e-9475-753f10a95e94", fields=["owners"])# Get by fully qualified nameclassification = Classifications.retrieve_by_name("Certification")# Get by name with fieldsclassification = Classifications.retrieve_by_name( "Certification", fields=["owners"])
// client is an initialized OpenMetadataClient.var classification = client.classifications().get("06d90883-6be9-4f7e-9475-753f10a95e94");// Get by ID with fieldsvar classificationWithFields = client.classifications().get( "06d90883-6be9-4f7e-9475-753f10a95e94", "owners");// Get by fully qualified namevar classificationByName = client.classifications().getByName("Certification");// Get by name with fieldsvar classificationByNameWithFields = client.classifications().getByName( "Certification", "owners");
# Get by IDcurl "{base_url}/api/v1/classifications/06d90883-6be9-4f7e-9475-753f10a95e94" \ -H "Authorization: Bearer {access_token}"# Get by ID with fieldscurl "{base_url}/api/v1/classifications/06d90883-6be9-4f7e-9475-753f10a95e94?fields=owners" \ -H "Authorization: Bearer {access_token}"# Get by fully qualified namecurl "{base_url}/api/v1/classifications/name/Certification" \ -H "Authorization: Bearer {access_token}"# Get by name with fieldscurl "{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