Learn about our new features recently updated daily.

Learn More

Get domain verification signature

Used to get the signature for domain verification process.

API

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

Required scope: signature_verify

Request headers

Authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Request parameter

application_token

string

required

A unique token for identifying the application in your account

Response

status

string

Used to know the domain verification status of the application

url

string

URL of the application

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

fileSignature

object

Object contains file verification details

dnsSignature

object

Object contains dns verification details

apiSignature

object

Object contains api verification details

Finalize the domain verification process using the Complete Domain Verification API. This step ensures that the domain is successfully verified before conducting security tests.

Last modified: 2025/03/10

Example request

cURL

Java

                    curl --location --request GET \
                    'https://api.beaglesecurity.com/rest/v2/applications/signature?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 domain verification signature
                    String applicationToken = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
                    Signature signature = client.getSignature(applicationToken);

Response

201 400 401

                    {
"status": "NotVerified",
"url": "https://example.com",
"code": "SUCCESS",
"message": "Success.",
"fileSignature": {
"signature": "_6r9lcxjztpnlps4sby648drxmz02zdlb"
},
"dnsSignature": {
"type": "TXT",
"name": "_31tervvaz40jy7bn543hux0hji296ovd",
"value": "_6r9lcxjztpnlps4sby648drxmz02zdlb"
},
"apiSignature": {
"type": "API",
"path": "_31tervvaz40jy7bn543hux0hji296ovd",
"value": "_6r9lcxjztpnlps4sby648drxmz02zdlb"
}
}

                    {
"code": "INVALID_SESSION",
"message": "Given token is invalid."
}

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

Next