Getting Started
Make your first API call in under 5 minutes.
2
Get Your API Key
Navigate to Settings → Developer → API Keys to create your first API key. Choose the appropriate scope for your use case:
read- Read-only access to filings and policieswrite- Create and update filingssubmit- Submit filings to state portalsadmin- Full access including organization settings
Important: Your API key will only be shown once. Store it securely.
3
Make Your First Request
Test your API key by listing your filings:
cURL
curl https://api.arqu.io/api/v1/filings \
-H "Authorization: Bearer YOUR_API_KEY"Python
import requests
response = requests.get(
"https://api.arqu.io/api/v1/filings",
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
print(response.json())JavaScript
const response = await fetch(
"https://api.arqu.io/api/v1/filings",
{
headers: {
"Authorization": "Bearer YOUR_API_KEY"
}
}
);
const data = await response.json();
console.log(data);4
Create a Filing
Submit your first surplus lines tax filing:
const response = await fetch(
"https://api.arqu.io/api/v1/filings",
{
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({
policy_number: "POL-2026-001",
effective_date: "2026-02-01",
expiration_date: "2027-02-01",
gross_premium: 25000.00,
home_state: "TX",
insured_name: "Acme Corporation",
carrier_naic: "12345"
})
}
);
const filing = await response.json();
console.log(filing.id); // Your new filing ID