Katalis Watch API
The Watch API from Katalis — 3 operation(s) for watch.
The Watch API from Katalis — 3 operation(s) for watch.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/meetkatalis-com:meetkatalis-com-watch-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Katalis UK Business Intelligence Watch API
version: 1.9.0
description: 'UK company checks from the official record, on one key: the checking record a developer can trust before their business works with, pays, hires from or bids against a UK company. Companies House (profiles, officers, PSCs, charges, filings, filed accounts read into plain figures), the Payment Practices reports and the PPN 018 tests, public contracts won, the Register of licensed sponsors, HMRC''s anti-money-laundering register, the SRA, CQC and charity registers (each with a daily change feed), the UK Sanctions List, the gender pay gap, Environment Agency registrations, directors'' and PSCs'' ID verification against their deadlines, every deadline a company has (also as a calendar feed), and a change feed with signed webhooks for any company you watch. Alongside: the document readers (Modern Slavery statements, Ofsted and CQC reports, charity accounts), the Business Score and fit assessment, tender matching, AI visibility, and the design APIs (brand kit, generative art, effects, logos). Every reply says where it came from and carries the source''s attribution; people''s details go only to verified accounts. Get a free API key (100 credits a month, no card) at https://meetkatalis.com/developers and send it as the `x-api-key` header. Also: every API as Markdown at https://meetkatalis.com/apis.md, an MCP server for AI agents at https://meetkatalis.com/mcp, live status at https://meetkatalis.com/apis/about.
Response conventions (since 2 October 2026): keys are camelCase on every endpoint; a registered company is `company: { name, number, status, statusDetail?, filingsOverdue?, ... }` on the register endpoints; the enrichment family (enrich, score, assess, brand-kit, ai-visibility, tender-match) keeps `business` / `profile` with `companyNumber` where one was matched, because its subject may be any business; an error reply that echoes what was asked for says `query`. Every error carries `code` and `requestId`; every reply an `x-request-id` header (since 1.9.0, 10 October 2026, the keyless and demo calls and the unknown-path 404 included); a charged reply `x-credits-remaining`; a reply that gave credits back `x-credits-refunded`; an error reply that was charged (a lookup that found nothing still ran) says `creditsCharged`. `company` carries `status` (and `statusDetail`, `filingsOverdue` when they apply) wherever the register was read for the reply; the report-based APIs (payment practices, PPN 018, gender pay gap, will-they-pay) give the name and number their report carries. Rate limits: monthly credit quota per plan plus a burst ceiling of 60 requests/minute per key (429 with no credit used). A request that fails on our side (any 5xx, including one that runs past its time limit) gives its credits back, and the x-credits-refunded header says how many; in a batch, items we couldn''t read are credited back and creditsRefunded says how many. Contains public sector information licensed under the Open Government Licence v3.0. Environment Agency register data is used under the Environment Agency Conditional Licence.'
contact:
name: Katalis
url: https://meetkatalis.com/apis
email: katalis@meetkatalis.com
license:
name: Katalis API Terms of Use (data from public sources keeps its own licence, e.g. the Open Government Licence v3.0)
url: https://meetkatalis.com/apis/terms
x-logo:
url: https://meetkatalis.com/icon.svg
altText: Katalis
servers:
- url: https://meetkatalis.com
tags:
- name: Watch
paths:
/api/v1/watch:
get:
operationId: listWatches
x-credits: 0
summary: The companies this key watches, with the last state seen
description: Free. Each watch carries the state last read (status, filings due, counts of directors and PSCs, ID verification still open, distress level, sanctions, latest payment report, awards, sponsor licence) and whether it's paused.
security:
- ApiKeyAuth: []
responses:
'200':
description: watching, limit, creditsPerCompanyPerMonth, watches[]
'401':
description: Missing or wrong x-api-key
'403':
description: Not a customer key
tags:
- Watch
post:
operationId: watchCompany
x-credits: 2 per company per calendar month (charged on the first watch of the month)
summary: Watch a company
description: Reads the company today and records its state; from tomorrow's daily read on, every change is an event. 2 credits now (this month), then 2 per calendar month on the first read of the month. A key out of credits has its watches paused, with an event saying so, until credits are there. Each plan watches up to a limit (free 10; paid a quarter of the monthly credits).
security:
- ApiKeyAuth: []
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- company
properties:
company:
type: string
description: A Companies House number
label:
type: string
maxLength: 120
responses:
'200':
description: company, name, watching, label, state, creditsCharged
'400':
description: Not a company number
'402':
description: The plan's watch limit is reached (code watch_limit)
'404':
description: No company with that number
'503':
description: Companies House couldn't be read; nothing charged
tags:
- Watch
delete:
operationId: unwatchCompany
x-credits: 0
summary: Stop watching a company
security:
- ApiKeyAuth: []
parameters:
- name: company
in: query
required: true
schema:
type: string
responses:
'200':
description: 'company, watching: false'
'404':
description: Not being watched
tags:
- Watch
/api/v1/watch/events:
get:
operationId: watchEvents
x-credits: 0
summary: The watch's event feed
description: Free. Oldest first after `since` (an event id); keep the last id you saw. Kinds include status, name, address, sic, accounts_overdue, accounts_filed, accounts_due, confirmation_overdue, confirmation_filed, officers, pscs, idv, distress, distress_signal, sanctions, sanctions_cleared, payment_report, contract_award, sponsor_added, sponsor_removed, sponsor_changed, not_found, watch_paused, watch_resumed.
security:
- ApiKeyAuth: []
parameters:
- name: since
in: query
required: false
schema:
type: integer
- name: company
in: query
required: false
schema:
type: string
- name: limit
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 500
default: 100
responses:
'200':
description: events[] {id, watchId, company, seenAt, kind, summary, before, after, deliveredToWebhook}, lastId, more
tags:
- Watch
/api/v1/watch/webhook:
put:
operationId: setWatchWebhook
x-credits: 0
summary: Where events are posted
description: 'Free. A public https address. The signing secret comes back once. Each delivery is a JSON body of the form { "events": [ ... ] } with the header X-Katalis-Signature "t=,v1=.'' with the secret>"; answer 2xx within 10 seconds, or it''s retried five times over two days.'
security:
- ApiKeyAuth: []
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- url
properties:
url:
type: string
format: uri
responses:
'200':
description: url, active, secret (once), verify (how to check the signature, with a worked example)
'400':
description: Not a public https address
tags:
- Watch
get:
operationId: getWatchWebhook
x-credits: 0
summary: The webhook on this key
security:
- ApiKeyAuth: []
responses:
'200':
description: url, active, recentFailures, since
tags:
- Watch
delete:
operationId: deleteWatchWebhook
x-credits: 0
summary: Switch the webhook off (the feed keeps everything)
security:
- ApiKeyAuth: []
responses:
'200':
description: 'active: false'
tags:
- Watch
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key