Katalis Watch API

The Watch API from Katalis — 3 operation(s) for watch.

GitHub OpenAPI

Operations 7

GET /api/v1/watch The companies this key watches, with the last state seen #
POST /api/v1/watch Watch a company #
DELETE /api/v1/watch Stop watching a company #
GET /api/v1/watch/events The watch's event feed #
PUT /api/v1/watch/webhook Where events are posted #
GET /api/v1/watch/webhook The webhook on this key #
DELETE /api/v1/watch/webhook Switch the webhook off (the feed keeps everything) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/meetkatalis-com:meetkatalis-com-watch-api"
All apis
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.

Get an API 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 Specification

meetkatalis-com-watch-api-openapi.yml Raw ↑
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