List Labels

List annotation labels with optional filters.

List Labels

List annotation labels in your organization with optional filters. Results are paginated.

GET https://api.futureagi.com/model-hub/annotations-labels/
Bearer 
          Click "Try It" to send a request

Authentication

All requests require authentication via API keys:

HeaderDescription
X-Api-KeyYour API key
X-Secret-KeyYour secret key

Query Parameters

type string

Filter by label type. One of text, categorical, numeric, star, or thumbs_up_down.

search string

Search labels by name (case-insensitive partial match).

include_usage_count boolean

When true, each label in the response includes a usage_count field showing how many scores reference it.

page integer

Page number for pagination.

page_size integer

Number of results per page.

Response

Returns a paginated response:

count integer
Total number of matching labels.
next string
URL for the next page, or null.
previous string
URL for the previous page, or null.
results array
Array of Label objects. Each contains id, name, type, description, settings, created_at, updated_at, and optionally usage_count.

Code Examples

import requests

url = "https://api.futureagi.com/model-hub/annotations-labels/"
headers = {
    "X-Api-Key": "YOUR_API_KEY",
    "X-Secret-Key": "YOUR_SECRET_KEY",
}

params = {
    "type": "star",
    "include_usage_count": "true",
    "page": 1,
    "page_size": 50,
}

response = requests.get(url, params=params, headers=headers)
data = response.json()

print(f"Total labels: {data['count']}")
for label in data["results"]:
    print(f"{label['name']} ({label['type']}) - used {label.get('usage_count', 'N/A')} times")
const params = new URLSearchParams({
  type: "star",
  includeUsageCount: "true",
  page: "1",
  pageSize: "50",
});

const response = await fetch(
  `https://api.futureagi.com/model-hub/annotations-labels/?${params}`,
  {
    headers: {
      "X-Api-Key": "YOUR_API_KEY",
      "X-Secret-Key": "YOUR_SECRET_KEY",
    },
  }
);

const data = await response.json();
console.log(`Total labels: ${data.count}`);
data.results.forEach((label: any) => {
  console.log(`${label.name} (${label.type}) - used ${label.usageCount ?? "N/A"} times`);
});
curl -G "https://api.futureagi.com/model-hub/annotations-labels/" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "X-Secret-Key: YOUR_SECRET_KEY" \
  --data-urlencode "type=star" \
  --data-urlencode "include_usage_count=true" \
  --data-urlencode "page=1" \
  --data-urlencode "page_size=50"
Was this page helpful?

Questions & Discussion