Skip to main content

​
API Reference

The Qalico REST API lets B2B clients integrate regulatory intelligence into their own products. Each API client gets access to one or more workspaces, with full control over profiles, subscriptions, references, and updates.

​
Base URL

​
Authentication

All requests require an API key passed via the X-API-Key header:
Alternatively, use the Authorization: Bearer header:
API keys are created in the Qalico back office. The raw key is shown once at creation — store it securely.

​
Workspace scoping

Most endpoints are scoped to a workspace. The API key determines which workspaces you can access. Requests to unauthorized workspaces return 403 Forbidden.

​
Errors

Error responses include a message field:

​
Typical workflow

1

Create a workspace

POST /api/workspaces with a name.
2

Generate a profile

POST /api/workspaces/:id/profile/generate with a company website URL. AI analyzes the site and creates a regulatory profile.
3

Generate subscriptions

POST /api/workspaces/:id/subscriptions/generate — AI recommends regulatory sources based on the profile.
4

Wait for impact assessment

After subscriptions are set, an impact assessment runs in the background. Updates will appear with priority and impact summaries once complete.
5

Query data

Use the GET endpoints to list references, updates, and their details.