API Reference

Complete reference for all API endpoints.

Base URL

https://api.arqu.io/api/v1

Endpoints

Create, retrieve, and manage surplus lines tax filings.

GET/filingsList all filings
POST/filingsCreate a filing
GET/filings/:idGet filing details
PATCH/filings/:idUpdate a filing
POST/filings/:id/submitSubmit to portal

Ingest and retrieve policy data from uploaded documents.

GET/policiesList policies
POST/policies/ingestUpload and extract policy
GET/policies/:idGet policy details

Manage webhook endpoints for real-time notifications.

GET/webhooksList webhooks
POST/webhooksCreate webhook
DELETE/webhooks/:idDelete webhook

Response Format

All API responses are returned as JSON. Successful responses include the requested data:

{
  "id": "fil_abc123",
  "policy_number": "POL-2026-001",
  "status": "draft",
  "created_at": "2026-01-15T10:00:00Z"
}

Error responses include a detail message:

{
  "detail": "Filing not found"
}

HTTP Status Codes

CodeDescription
200Request succeeded
201Resource created
400Invalid request parameters
401Authentication required
403Insufficient permissions
404Resource not found
429Rate limit exceeded
500Internal server error