Learn about our new features recently updated daily.

Learn More

Get an application using application token

Used to get details of an application using an application token in your Beagle Security account.

API

GET https://api.beaglesecurity.com/rest/v2/applications?application_token={application_token}

Required scope: read_project

Request headers

Authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Request Parameter

application_token

string

required

A unique key for identifying the project

Response

code

string

Status code for the API call.

Values are:

SUCCESSAPI call is success
PLAN_NOT_SUPPORTEDYour plan does not support this feature.
PROJECT_ALREADY_EXISTSProject already exists in your account.
INVALID_SESSIONInvalid session
FAILEDFailed to create project.
NOT_AUTHORIZEDUser authentication failed.

message

string

Success/failure message for the API call

application

object

Application object which contains details of an application

Need to update an application? The Modify an Application APIenables you to make changes to an existing application's details effortlessly.

Last modified: 2025/03/10

Example request

cURL

Java

                    curl --location --request GET \
                    'https://api.beaglesecurity.com/rest/v2/applications?application_token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
                    --header 'Authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'

                    // This token will be generated from Beagle security settings -> Access token
                    BeagleSecurityClient client = BeagleSecurityClientBuilder.instance()
                        .withAPIToken("xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx")
                        .build();

                    // Get application
                    String applicationToken = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
                    Application application = client.getApplication(applicationToken);

Response

200 400 401

                                {
"code": "SUCCESS",
"message": "Success",
"application": {
"name": "Test",
"url": "http://196.168.0.7:80",
"applicationToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"applicationType": "WEB",
"signatureStatus": "Verified",
"hostingType": "internal"
}
}

                                {
"code": "INVALID_APPLICATION_TOKEN",
"message": "Given token is invalid"
}

                                {
"code": "NOT_AUTHORIZED",
"message": "Not authorized"
}

Next