Authentication

Load Testing API uses HTTP Basic Auth for authentication with your BrowserStack credentials.

You need to pass your BrowserStack account credentials in each request.

HTTP Basic Auth

All Load Testing API endpoints require HTTP Basic Auth. Pass your username and Access Key as BROWSERSTACK_USERNAME:BROWSERSTACK_ACCESS_KEY in the Authorization header:

curl -u $BROWSERSTACK_USERNAME:$BROWSERSTACK_ACCESS_KEY \
  https://load-api.browserstack.com/api/v1/runs/{run_id}/status

Get your credentials

You can view and manage your Load Testing credentials from the Load Testing Dashboard:

1. Log in to your Load Testing dashboard.
2. Click Settings.
3. Under API Access, find:
   • Username: your Load Testing username
   • Access Key: your unique API access key

Keep your Access Key confidential. If exposed, regenerate it immediately from the Settings page.

Any valid Access Key in your group can trigger, stop, and read results for any run in that group. There are no separate read-only or read-write credentials in v1. Handle credentials accordingly when sharing with CI/CD systems or teammates.

Example request with credentials

curl -u "your_username:your_access_key" -X POST \
  https://load-api.browserstack.com/api/v1/runs \
  -H "Content-Type: application/json" \
  -d '{
    "project_name": "my-project",
    "test_name": "checkout-flow"
  }'

Environment variables

For security, store your credentials as environment variables:

export BROWSERSTACK_USERNAME="your_username"
export BROWSERSTACK_ACCESS_KEY="your_access_key"

curl -u $BROWSERSTACK_USERNAME:$BROWSERSTACK_ACCESS_KEY \
  https://load-api.browserstack.com/api/v1/runs/{run_id}/status

Troubleshooting