Get Total Scenario Count by Filter
This endpoint retrieves the total number of scenarios that match the provided filters. The user must have the SCENARIO_VIEW authority to access this endpoint.
Endpoint Information
- URL: https://testinium.io/Testinium.RestApi/api/scenarios/totalCountByfilter
- Method: GET
- Authentication: Required (Bearer Token)
- Header: Required (current-company-id: <your_company_id>)
Request Parameters
Parameter | Type | Required | Description |
|---|---|---|---|
projectId | Long | No | The unique ID of the project to filter scenarios. |
planId | Long | No | The unique ID of the test plan to filter by. |
scenarioText | String | No | A text snippet to filter scenarios by content. |
Response
The response returns the total count of scenarios that match the specified filters.
713Response Fields
Field | Type | Description |
|---|---|---|
totalCount | Long | The total number of scenarios matching the filters. |
Error Codes
HTTP Code | Error Message | Description |
|---|---|---|
403 | ACCESS_DENIED | User lacks SCENARIO_VIEW authority. |
400 | INVALID_REQUEST | The request was malformed or contained invalid parameters. |
404 | USERS_COMPANY_NOT_EXISTS | No company was found for the current user. |
500 | SYSTEM_INTERNAL_ERROR | An unexpected error occurred on the server side. |
Example Request
curl --location --request GET 'https://testinium.io/Testinium.RestApi/api/scenarios/totalCountByfilter?projectId=123&planId=456&scenarioText=example' \
--header 'Authorization: Bearer <your_access_token>' \
--header 'current-company-id: <your_company_id>'