Get build list API in Automated tests
Use this API to get a list of builds executed by the Automated tests along with the basic details of these builds.
get build list
If Geo Region Restriction (GRR) is enabled for your account, add your region code to the host name:
api-accessibility-<region>.browserstack.com. See Geo Region Restriction endpoints for the region codes and examples.
Request parameters
Request
curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
https://api-accessibility.browserstack.com/api/automated-tests/v1/builds
-
next_page String
Used to fetch subsequent pages from the API when has_next parameter is true. Pass the next_page reference received in the response of last request.
Response Attributes 200 OK JSON
Response
{
"builds": [
{
"id": 24679542,
"buildNumber": 18719,
"name": "browserstack build",
"startedAt": "2024-12-17T13:20:22.258Z",
"wcagVersion": "WCAG 2.1 AA",
"recurring": true,
"active": true,
"status": isProcessing,
"advanced": true,
"localTestingEnabled": false,
"authEnabled": false
"pageCount": 1,
"createdBy": {
"id": 8851962,
"name": "John Doe"
},
"projectId": 41221,
"thBuildId": "ntdqqt9pazdrwwewbbdorf582pvsr0cuxawnvrla",
"status": "failed"
},
{
...
}
],
"pagination": {
"has_next": true,
"next_page": "eyJhbGciOiJIUzI1NiJ9.eyJwYWdlIjoxLCJwYWdlX3NpemUiOjEwLCJidWlsZF91dWlkIjoic3pkdGplMnhsaHNydWZkajF3bnJnYnZndnNmZzJjdGRsdWt4Nnl5eCIsImV4cCI6MTczNjY4NDA1OH0.sLI7hWQwE_bB6AB-ORgz1K6D2VIHqH_H39qK8Jh3HqA"
}
}
-
id Integer
Unique ID of the build.
-
buildNumber Integer
Build number of the build.
-
name String
Name of the build.
-
startedAt String
Timestamp of when the build started.
-
wcagVersion String
WCAG version against which the build was run.
- Show 11 more
-
recurring Boolean
True if it is a recurring build.
-
active Boolean
True if a the build is still active.
-
status String
The status of the report.
-
advanced Boolean
True if reporting of issues in violation of advanced rules is enabled.
-
localTestingEnabled Boolean
True if local testing is enabled in the build.
-
authEnabled Boolean
True if authorization is enabled in the build.
-
pageCount Integer
Number of pages in the build.
-
createdBy Object
▶ SHOW VALUESSpecifies the id and name of the creator of the report.
-
id Integer
ID of the report creator.
-
name String
Name of the report creator.
-
-
projectId Integer
The project ID associated with the build.
-
thBuildId String
Unique build code generated internally.
-
pagination Object
▶ SHOW VALUESContains information to facilitate fetching additional records if they exist.
-
has_next Boolean
True if there are more records to fetch. False if the current response is the last page of records.
-
next_page String
A reference to the next page. Pass this as a request parameter in the subsequent request as “next_page” to get the next page of records.
-
Filter using project id
If you need to retrieve the builds of a specific project, you can pass the project ID along with the API request.
The following API request is an example:
Request to filter using project id
curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" https://api-accessibility.browserstack.com/api/automated-tests/v1/builds?projectId=<projectId>
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.