from metadata.sdk import configure
from metadata.sdk.entities import Tags

configure(
    host="https://your-company.getcollate.io/api",
    jwt_token="your-jwt-token"
)

# List first page
tags = Tags.list(limit=50)
for t in tags.data:
    print(f"{t.fullyQualifiedName}")

# List all with auto-pagination
for t in Tags.list_all():
    print(f"{t.fullyQualifiedName}")

# Filter by classification
tags = Tags.list(
    parent="Certification",
    fields=["owners", "children"],
    limit=50
)

for t in tags.data:
    print(f"{t.fullyQualifiedName}")
    if t.style:
        print(f"  Color: {t.style.get('color')}")

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

// List first page
var result = Tags.list()
    .limit(50)
    .execute();

for (var t : result.getData()) {
    System.out.println(t.getFullyQualifiedName());
}

// Filter by classification with fields
var result = Tags.list()
    .parent("Certification")
    .fields("owners", "children")
    .limit(50)
    .execute();

# List all
curl "{base_url}/api/v1/tags?limit=50" \
  -H "Authorization: Bearer {access_token}"

# Filter by classification
curl "{base_url}/api/v1/tags?parent=Certification&fields=owners,children&limit=50" \
  -H "Authorization: Bearer {access_token}"

{
  "data": [
    {
      "id": "68ec158c-5f5e-4277-8a19-5e9e0cd5294f",
      "name": "Bronze",
      "fullyQualifiedName": "Certification.Bronze",
      "description": "Bronze certified Data Asset.",
      "style": {
        "color": "#C08320"
      },
      "version": 0.1,
      "updatedAt": 1769982619666,
      "updatedBy": "admin",
      "classification": {
        "id": "06d90883-6be9-4f7e-9475-753f10a95e94",
        "type": "classification",
        "name": "Certification",
        "fullyQualifiedName": "Certification",
        "deleted": false
      },
      "deleted": false,
      "owners": [],
      "provider": "system",
      "mutuallyExclusive": false
    }
  ],
  "paging": {
    "after": "...",
    "total": 3
  }
}