Testinium Enterprise
  • TESTINIUM ENTERPRISE
    • Testinium Enterprise Documentation
  • Login
    • User Login
    • Reset Password
  • Dashboard
    • Dashboard
    • User Profile
    • Company Details
  • System Settings
    • System Settings
      • Licence Information
        • Add New Licence Key
        • Edit Licence Key
        • Delete Licence Key
        • Update Public Key
      • General Test Plan Settings
      • System Properties
        • Creating New System Property
        • Edit Property
        • Delete Property
      • Selenium Hubs
        • Creating Selenium Hub
        • Edit Selenium Hub
        • Delete Selenium Hub
      • Role / Permission Management
        • Roles
          • Create New Role
          • Edit Role
          • Delete Role
        • Permission
          • Create New Permission
          • Edit Permission
          • Delete Permission
      • Browsers / Phones
        • Create New Phone/Browser
        • Edit Phone/Browser
        • Delete Browser/Phone
      • Test Environments
        • Create New Environment
        • Edit Enviroment
        • Delete Environment
      • Test Environment Status
      • Active Tests
      • Screen Resolutions
        • Create New Screen Resolution
        • Edit Screen Resolution
        • Delete Screen Resolution
      • Predefined Exceptions
        • Create Predefined Exception
        • Edit Predefined Exception
        • Delete Predefined Exception
      • Cloud Test Environment
      • Cloud Test Environments Groups
        • Create Cloud Environment Group
        • Edit Cloud Environment Group
        • Delete Cloud Environment Group
      • Notifications
      • Project Clone
      • Company’s Scheduled Plan
  • Companies
    • Companies
      • Create New Company
      • Edit Company
  • Users
    • Users
      • Create New User
      • Edit User
      • Delete User
      • Manage Roles
  • Projects
    • Projects
      • Create New Project
      • Edit Project
      • Delete Project
  • Plans
    • Plans
      • Create Plan
      • Edit Plan
      • Delete Plan
      • Test Report
      • Run Test Plan
      • Show Running Test Plan
      • Run with Tag
      • New Tag
  • Scenarios
    • Scenarios
      • Create New Scenarios
      • Create New Group
      • New Sub Scenario
      • Edit Scenario
      • Delete Scenario
      • Export Excel
  • BDD EDITOR
    • Create Concept File
    • Create Spec File
    • Create Feature File
  • REPORTS
    • Test Executions (Auto)
      • Test Result Reports
    • Test Execution(Remote)
    • Detailed Reports
      • Test Result Report
    • Instant Reports
    • Scheduled Report
      • Create New Periodically Reports
      • Edit Periodically Report
      • Delete Periodically Report
      • Report History
    • Graph Report
    • Execution Graph
    • Pass Rate Reports
    • Test Executions (Tag)
    • Test Result by Period
  • Plugins
    • Plugins
      • Jenkins
      • Azure Devops Board
      • Jira
      • Testinium Cloud
  • API's
    • Auth
      • Login
    • Project
      • Get All Projects
      • Get Project by ID or Name
      • Get Projects by Company ID
      • Get Active Project By ID
      • Get All Projects by User's Companies
      • Get All Companies
      • Create Project
      • Update Project
      • Upload File to Project
      • Delete Mobile App
    • Scenario
      • Get All Scenarios
      • Get Scenarios Of Plan
      • Get Scenario by Name or ID
      • Get Scenarios by User Company
      • Get Test Parameters
      • Create Scenario
      • Update Scenario
      • Update Test Parameters
    • Plan
      • Get All Plans
      • Get All Plans By Project Name or ID
      • Get All Plans by User's Companies
      • Get Plans Of Scenario
      • Get All Active Plans by Project ID
      • Get Plan By ID
      • Get Plan By Project And Plan Name Or Id
      • Get Active Plan By ID
      • Create Test Plan
      • Update Test Plan
      • Update Selected Android Mobile App for Test Plan
      • Update Selected iOS Mobile App for Test Plan
      • Run Test Plan
      • Run Test Plan with Company ID
      • Rerun Test Plan
      • Stop Test Plan
      • Check If Test Plan Is Running
    • Reports
      • Get Test Execution by ID
      • Get All Test Executions by Plan
      • Get All Test Executions by Plan and Page
      • Get Test Result by ID
      • List Test Results by Execution ID
      • List Test Results
  • RELEASE NOTES
    • Release Notes
      • Testinium-Enterprise 1.16.7 Release Notes
      • Testinium-Enterprise 1.16.6 Release Notes
      • Testinium-Enterprise 1.16.5 Release Notes
      • Testinium-Enterprise 1.16.4 Release Notes
      • Testinium-Enterprise 1.16.3 Release Notes
      • Testinium-Enterprise 1.16.2 Release Notes
      • Testinium-Enterprise 1.15.1 Release Notes
      • Testinium-Enterprise 1.15.0 Release Notes
      • Testinium 1.14.4 Release Notes​
      • Testinium 1.14.1 Release Notes
      • Testinium 1.14.0 Release Notes
      • Testinium 1.13.4 Release Notes
      • Testinium 1.13.0 – 1.13.3 Release Notes
  • Appium 2 Sample Projects
    • Appium 2 Sample Projects
      • Appium 2 Java
        • BaseTest
        • IOSTest And AndroidTest
        • Hook
      • Appium 2 Gauge
        • HookImp
        • pom.xml
        • StepImp
        • Spec File
        • Concept File
Powered by GitBook
On this page
  • Endpoint Information
  • Path Variables
  • Response Body
  • Error Codes
  • Example Request
  1. API's
  2. Plan

Get Plan By ID

The endpoint retrieves a test plan based on the plan's name or ID. The test plan is returned as a PlanDTO object.


Endpoint Information

  • URL: <custom-env-url>/Testinium.RestApi/api/plans/{planNameOrId}

  • Method: GET

  • Authentication: Requires Bearer Token


Path Variables

Parameter
Type
Required
Description

planNameOrId

Object

Yes

The name or ID of the test plan.


Response Body

Upon a successful request, the API returns the test plan in JSON format.

[
    {
        "id": 261,
        "project_id": 580,
        "company_id": 1,
        "plan_name": "Android",
        "group_plan": false,
        "description": "",
        "enabled": true,
        "plan_parallel_test_limit": 36,
        "scenarios": [
            3076,
            3077,
            3078,
            3079,
            3080,
            3056,
            3087,
            3086,
            3100
        ],
        "period": {
            "period_type": "MANUAL",
            "days_of_week": "2,3,4,5,6,7,1",
            "repeat_period": 60
        },
        "alerts": [],
        "alerts_enabled": false,
        "failed_test_retry_count": 3,
        "screen_shot_type": "YES",
        "video_enabled": false,
        "environments": [
            {
                "id": 9
            },
            {
                "id": 13
            }
        ],
        "clear_app_data": false,
        "fetch_app_files": [],
        "selected_android_mobile_app": {
            "id": 54,
            "mobile_app_name": "pegasus-pilot-release-2.39.0.38__2_-ee15733f-2799725523214323595.apk",
            "mobile_app_hash": "57e487d42eaa459b1713df8c1dd691a8",
            "operating_system": "ANDROID",
            "mobile_app_metadata": "{\"packageName\":\"com.pozitron.pegasus.pilotRelease\",\"label\":\"PGS Pilot\",\"icon\":\"res/u3.png\",\"versionName\":\"2.39.0.38\",\"versionCode\":119,\"minSdkVersion\":\"23\",\"targetSdkVersion\":\"33\"}",
            "created_at": "2024-10-18 09:34:30"
        },
        "selected_ios_mobile_app": {
            "id": 53,
            "mobile_app_name": "Gratis-b250541b__2_-8988176051238453961.ipa",
            "mobile_app_hash": "556372e35d7f2b6fa4b7ceb4c0af8b58",
            "operating_system": "IOS",
            "mobile_app_metadata": "{\"bundleName\":\"Gratis\",\"bundleDisplayName\":\"Gratis\",\"bundleVersion\":\"3.2.12\",\"bundleMinOsVersion\":\"12.0\",\"bundleDevelopmentRegion\":\"tr\",\"bundleExecutable\":\"Gratis\",\"bundleIconFiles\":\"\",\"bundleInfoDictVersion\":\"6.0\",\"bundlePackageType\":\"APPL\",\"bundleMainStoryBoardFile\":\"Main\"}",
            "created_at": "2024-10-18 09:34:30"
        }
    }
]
Field
Type
Description

id

integer

The unique ID of the test plan.

plan_name

string

The name of the test plan.

description

string

A brief description of the test plan.

project_id

integer

The ID of the associated project.

company_id

integer

The ID of the associated company.

enabled

boolean

Whether the plan is enabled or not.

scenarios

array

A list of scenario IDs associated with the plan.

period

object

The period configuration for the plan.

alerts

array

A list of alerts associated with the plan.

video_enabled

boolean

Whether video recording is enabled for the plan.

environments

array

A list of environments related to the plan.

clear_app_data

boolean

Whether app data should be cleared.

fetch_app_files

array

A list of files to be fetched for the plan.


Error Codes

Possible error codes and their explanations during the operation:

HTTP Code
Error Message
Description

401

Unauthorized

Authorization failed. User is not logged in.

403

Forbidden

User does not have permission to access the specified plan.

404

Plan not found

The specified plan was not found.

500

Internal Server Error

An unexpected error occurred on the server.


Example Request

curl --location '<custom-env-url>/Testinium.RestApi/api/plans/{planNameOrId}' \
--header 'Authorization: Bearer <your_access_token>'
PreviousGet All Active Plans by Project IDNextGet Plan By Project And Plan Name Or Id

Last updated 2 months ago