Skip to content
Testsigma DOCS

Get elements

GET/ui_identifiers

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

Retrieve all elements (UI identifiers) available in the project.

Authenticate with your API key as a Bearer token in the Authorization header. Generate a key →
idUnique element identifier.
nameName of the element.
locatorTypeLocator strategy — xpath, css_selector, id, name, classname, linktext, tagname.
definitionThe locator expression used to find the element.
statusReview status — READY or DRAFT.
screenNameIdID of the screen the element belongs to.
applicationVersionIdID of the application version.
createdTypeHow the element was created — CHROME, ADVANCED, or MANUAL.
createdByIdID of the user who created the element.
REQUEST
curl -X GET \
  'https://app.testsigma.com/api/v1/ui_identifiers' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json'
const response = await fetch('https://app.testsigma.com/api/v1/ui_identifiers', {
  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/ui_identifiers',
  headers={
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  }
)
data = response.json()
RESPONSE200OK
{
  "content": [
    {
      "id": 101,
      "name": "Login Button",
      "locatorType": "xpath",
      "definition": "//button[@id='login-btn']",
      "status": "READY",
      "screenNameId": 12,
      "applicationVersionId": 39,
      "createdType": "CHROME",
      "createdById": 9
    },
    {
      "id": 102,
      "name": "Email Input",
      "locatorType": "id",
      "definition": "email-input",
      "status": "READY",
      "screenNameId": 12,
      "applicationVersionId": 39,
      "createdType": "MANUAL",
      "createdById": 9
    }
  ],
  "totalElements": 2,
  "totalPages": 1
}