Skip to content
Testsigma DOCS
Login Book a demo

Get a step group

GET/projects/:project_id/step_groups/:step_group_id

Base URL  https://test-management.testsigma.com/api/v1

Retrieves the details of a specific step group, including its steps and metadata.

Authenticate with your API key as a Bearer token in the Authorization header. Generate a key →

PATH PARAMETERS

project_idUnique identifier of the project the step group belongs to.
step_group_idIdentifier of the step group to retrieve.

RESPONSE ATTRIBUTES

messageStatus message for the request; may be empty.
data.step_group.idUnique identifier of the step group.
data.step_group.titleTitle of the step group.
data.step_group.descriptionDescription of the step group.
data.step_group.human_idHuman-readable identifier for the step group.
data.step_group.steps[].idUnique identifier of the step.
data.step_group.steps[].step_descriptionDescription of the step.
data.step_group.steps[].expected_resultsExpected results of the step.
data.step_group.steps[].orderOrder of the step within the step group.
data.step_group.steps[].step_group_idIdentifier of the step group the step belongs to.
data.step_group.steps[].created_atUnix timestamp of when the step was created.
data.step_group.steps[].updated_atUnix timestamp of the last update to the step.
data.step_group.project_idIdentifier of the project the step group belongs to.
data.step_group.created_atUnix timestamp of when the step group was created.
data.step_group.updated_atUnix timestamp of the last update to the step group.
REQUEST
curl -X GET \
  'https://test-management.testsigma.com/api/v1/projects/:project_id/step_groups/:step_group_id' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json'
const response = await fetch('https://test-management.testsigma.com/api/v1/projects/:project_id/step_groups/:step_group_id', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  }
});
const data = await response.json();
import requests

response = requests.get(
  'https://test-management.testsigma.com/api/v1/projects/:project_id/step_groups/:step_group_id',
  headers={
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  }
)
data = response.json()
RESPONSE200OK
{
  "message": "",
  "data": {
    "step_group": {
      "id": "b3d9f1a2-6c84-4e57-9a01-2f7c5d8e1b40",
      "title": "Regression Test Step Group - 5",
      "description": "Step group for regression test cases",
      "human_id": "DEMO-SG-1",
      "steps": [
        {
          "id": "f1c2a3b4-5d6e-47f8-9a0b-1c2d3e4f5a6b",
          "step_description": "Open the application and navigate to the login page",
          "expected_results": "Login page should be displayed",
          "order": 1,
          "step_group_id": "b3d9f1a2-6c84-4e57-9a01-2f7c5d8e1b40",
          "created_at": 1710675200,
          "updated_at": 1710675200
        },
        {
          "id": "a7b8c9d0-1e2f-43a4-85b6-7c8d9e0f1a2b",
          "step_description": "Enter valid credentials and click login",
          "expected_results": "User should be redirected to the dashboard",
          "order": 2,
          "step_group_id": "b3d9f1a2-6c84-4e57-9a01-2f7c5d8e1b40",
          "created_at": 1710675200,
          "updated_at": 1710675200
        }
      ],
      "project_id": "c47ade67-0543-4582-a4a5-b7de447c94f5",
      "created_at": 1710675200,
      "updated_at": 1710675200
    }
  }
}