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')}")

{
  "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
  }
}