Learn about our new features recently updated daily.

Learn More

Status of a Test

Get the status of a test that triggered from the API.

API

POST https://api.beaglesecurity.com/v1/test/status

Request headers

Content-Type: application/json

Request body

access_token

A unique token for accessing the API

application_token

A unique token for identifying the application in your account

result_token

A unique key for identify result session

Response

status

Status code for the API call

progress

Percentage of test completed

message

Success/failure message for the API call

message

Success/failure message for the API call

Need to halt a running test? The Stop a Test API allows you to cancel an ongoing security test at any stage.

Last modified: 2025/03/10

Example request

cURL

                    curl --location --request POST \
'https://api.beaglesecurity.com/v1/test/status' \
--header 'Content-Type: application/json' \
--data-raw '{
"access_token":"7i8cesnridfk0ha65ufm03gctsikiici",
"application_token": "1iwg9chvbqb2uxvtxd8c3bf9c5t026xu",
"result_token":"y4lwsplywaoz135n70b7d49537zk9pbo"
}'

Response

200 400

                    {
"status": "running" ,
"progress": 30,
"message": "Test has started successfully."
}

                    {
"status": "Failed",
"message": "Invalid application. Start test failed."
}

Next