Skip to content
Testsigma DOCS

Get test case labels

GET/tags

Base URL  https://app.testsigma.com/api/v1

Retrieve all labels (tags) available for test cases in the project.

Authenticate with your API key as a Bearer token in the Authorization header. Generate a key →
idUnique label identifier.
nameLabel name as displayed in the UI.
typeEntity type the label applies to — TESTCASE or TEST_CASE.
countNumber of test cases tagged with this label.
REQUEST
curl -X GET \
  'https://app.testsigma.com/api/v1/tags' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json'
const response = await fetch('https://app.testsigma.com/api/v1/tags', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  }
});
const data = await response.json();
import requests

response = requests.get(
  'https://app.testsigma.com/api/v1/tags',
  headers={
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  }
)
data = response.json()
RESPONSE200OK
{
  "content": [
    {
      "id": 1,
      "name": "Smoke",
      "type": "TESTCASE",
      "count": 12
    },
    {
      "id": 2,
      "name": "Regression",
      "type": "TESTCASE",
      "count": 48
    },
    {
      "id": 3,
      "name": "Sanity",
      "type": "TEST_CASE",
      "count": 7
    }
  ],
  "totalElements": 3,
  "totalPages": 1
}