Senserity API
Programmatic access to UK company risk intelligence. Query company profiles, risk scores, insight results, reports, and alerts from your own systems or AI agents.
Authentication
All API requests require a bearer token in the Authorization header. Tokens use the format sns_live_<body>_<checksum> and are created in Settings > API in the dashboard.
Authorization: Bearer sns_live_a7K9mN2p...x7k2p9See Authentication for full details on token format, scopes, and security practices.
Base URL
https://app.senserity.co.uk/api/v1/All endpoints are versioned under /v1/. The API runs on the same origin as the dashboard.
Rate limits
Rate limits are applied per API key. Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers. A 429 response includes a Retry-After header.
| Tier | Requests / minute | Requests / day |
|---|---|---|
| Professional | 20 | 2,000 |
| Enterprise | 60 | 10,000 |
Pagination
All list endpoints use cursor-based pagination. Pass limit to control page size (default 25, max 100) and cursor to continue from a previous result. The response meta.cursor field contains the next cursor value, and meta.has_more indicates whether more results exist.
Response format
Success responses return a data field with the result and a meta field with pagination and request metadata. Error responses return an error object.
Success
{
"data": { ... },
"meta": {
"cursor": "abc123",
"has_more": true,
"request_id": "req_..."
}
}Error
{
"error": {
"code": "not_found",
"message": "Company not found.",
"request_id": "req_..."
}
}Quick start
Search for a company and retrieve its risk profile in two calls:
# Search for a company
curl -s https://app.senserity.co.uk/api/v1/companies/search \
-H "Authorization: Bearer sns_live_your_key_here" \
-G -d "q=Blueloop+Limited"
# Get the risk summary
curl -s https://app.senserity.co.uk/api/v1/companies/03981322/risk \
-H "Authorization: Bearer sns_live_your_key_here"
# Response
{
"data": {
"company_number": "03981322",
"company_name": "BLUELOOP LIMITED",
"risk_grade": "A",
"risk_score": 8.7,
"categories": {
"financial": 12.3,
"governance": 0.6,
"compliance": 5.7,
"cyber": 31.5,
"legal": 2.2,
"media": 9.6,
"operational": 1.6,
"social_esg": 15.8,
"network": 2.3
},
"red_flag_count": 2,
"trajectory": "stable"
},
"meta": {
"request_id": "req_abc123"
}
}