API Documentation
- API Keys Overview & Getting Started
- Creating & Managing API Keys
- Authentication & Scopes
- Read-Only Endpoints Reference
- Error Handling & Troubleshooting
- Best Practices & Security
- Python Integration Examples
- JavaScript Integration Examples
- Bulk Import API, AIRTA & Imported Reports
- AILP - LLM compliance SDK (@airtasystems/ailp)
JavaScript Integration Examples
Jan 15, 2025
Overview
Simple JavaScript examples for working with the AIRTA Systems API using API keys.
Setup Instructions
Option 1: Run in Node.js
Node.js 18+ supports top-level await. Create a file (e.g., api_example.js) and run:
node api_example.js
For older Node.js versions, wrap your code in an async function:
async function main() {
// Your code here
const API_KEY = 'gb_live_your_api_key_here';
const response = await fetch('https://airtasystems.com/api/v2/submissions', {
headers: { 'Authorization': `Bearer ${API_KEY}` }
});
const data = await response.json();
console.log(data);
}
main();
Option 2: Run in Browser
Create an HTML file and include your JavaScript:
[script]
// Your JavaScript code here
const API_KEY = 'gb_live_your_api_key_here';
// ... rest of your code
[script]
Open the HTML file in your browser. Note: For production, use environment variables or a backend to protect your API key.
Basic Example
const API_KEY = 'gb_live_your_api_key_here';
// Get submissions
const response = await fetch('https://airtasystems.com/api/v2/submissions', {
headers: { 'Authorization': `Bearer ${API_KEY}` }
});
const data = await response.json();
console.log(JSON.stringify(data, null, 2));
All Endpoints
Get Programs
const API_KEY = 'gb_live_your_api_key_here';
const response = await fetch('https://airtasystems.com/api/v2/programs/company/my-programs', {
headers: { 'Authorization': `Bearer ${API_KEY}` }
});
const data = await response.json();
console.log(JSON.stringify(data, null, 2));
// With filters
const params = new URLSearchParams({ category: 'ai-safety' });
const filteredResponse = await fetch(`https://airtasystems.com/api/v2/programs/company/my-programs?${params}`, {
headers: { 'Authorization': `Bearer ${API_KEY}` }
});
const filteredData = await filteredResponse.json();
console.log(JSON.stringify(filteredData, null, 2));
Get Compliance Documents
const API_KEY = 'gb_live_your_api_key_here';
const response = await fetch('https://airtasystems.com/api/v2/compliance', {
headers: { 'Authorization': `Bearer ${API_KEY}` }
});
const data = await response.json();
console.log(JSON.stringify(data, null, 2));
// With filters
const params = new URLSearchParams({ programId: '123', status: 'approved' });
const filteredResponse = await fetch(`https://airtasystems.com/api/v2/compliance?${params}`, {
headers: { 'Authorization': `Bearer ${API_KEY}` }
});
const filteredData = await filteredResponse.json();
console.log(JSON.stringify(filteredData, null, 2));
Get Submissions
const API_KEY = 'gb_live_your_api_key_here';
const response = await fetch('https://airtasystems.com/api/v2/submissions', {
headers: { 'Authorization': `Bearer ${API_KEY}` }
});
const data = await response.json();
console.log(JSON.stringify(data, null, 2));
// With filters
const params = new URLSearchParams({ status: 'accepted' });
const filteredResponse = await fetch(`https://airtasystems.com/api/v2/submissions?${params}`, {
headers: { 'Authorization': `Bearer ${API_KEY}` }
});
const filteredData = await filteredResponse.json();
console.log(JSON.stringify(filteredData, null, 2));
Get Incident Reports
const API_KEY = 'gb_live_your_api_key_here';
const params = new URLSearchParams({ severity: 'high' });
const response = await fetch(`https://airtasystems.com/api/v2/incidents/reports?${params}`, {
headers: { 'Authorization': `Bearer ${API_KEY}` }
});
const data = await response.json();
console.log(JSON.stringify(data, null, 2));
Get FRIA Assessments
const API_KEY = 'gb_live_your_api_key_here';
const params = new URLSearchParams({ status: 'approved' });
const response = await fetch(`https://airtasystems.com/api/v2/fria/assessments?${params}`, {
headers: { 'Authorization': `Bearer ${API_KEY}` }
});
const data = await response.json();
console.log(JSON.stringify(data, null, 2));
Get Messages
const API_KEY = 'gb_live_your_api_key_here';
const params = new URLSearchParams({ submissionId: '123' });
const response = await fetch(`https://airtasystems.com/api/v2/messages?${params}`, {
headers: { 'Authorization': `Bearer ${API_KEY}` }
});
const data = await response.json();
console.log(JSON.stringify(data, null, 2));
Browser Example
const API_KEY = 'gb_live_your_api_key_here';
const response = await fetch('https://airtasystems.com/api/v2/submissions', {
headers: { 'Authorization': `Bearer ${API_KEY}` }
});
const data = await response.json();
console.log(JSON.stringify(data, null, 2));