API Access

Integrate Blue Lantern tools into your own workflows programmatically.

All marketplace tools are accessible via the REST API, allowing you to integrate security analysis into CI/CD pipelines, SOAR playbooks, or custom applications.

Getting Your API Key

1. Navigate to API Access from your account.
2. Click Generate API Key. Your key will be displayed once — copy it to a safe location.
3. Include the key in the Authorization header of every API request.

Authentication

Pass your API key in the Authorization header:

Authorization: YOUR_API_KEY

Account Scope (Organizations)

An API key is bound to the single account it was generated under — your personal account or a specific organization. Unlike the web app, an API key cannot switch accounts: it ignores the account switcher, and every request it makes runs against that one account and its Seat License coverage (API keys require an active seat plan on the account they belong to).

To use the API as a specific organization:

1. Open the account switcher on the Organization page and switch into that organization.
2. Go to API Access and generate a key while you're in that account. The key is now bound to that organization.
3. Use that key for all requests that should run as the organization. Keep separate keys for separate accounts.

The same applies to monitor keys (browser/email extensions) — each is scoped to the account it was created in.

Postman Collection

A postman collection is provided for your convenience at this link: Postman Collection

Example: Analyze an Email via cURL

curl -X POST "$API_URL/runs" \
  -H "Authorization: YOUR_API_KEY" \
  -F "tool=EMAILANALYZER" \
  -F "file=@/path/to/suspicious_email.eml"

Example: JavaScript (Fetch)

const formData = new FormData();
formData.append('tool', 'EMAILANALYZER');
formData.append('file', fileInput.files[0]);

const response = await fetch(API_URL + '/runs', {
  method: 'POST',
  headers: { 'Authorization': 'YOUR_API_KEY' },
  body: formData
});

const data = await response.json();
console.log(data);