UK SRA Firm Portfolio Status Monitor

Watch a list of SRA firm / organisation numbers and receive typed authorisation / licence events when the official SRA Data Share API flips — Authorised → Intervention / Closed / conditions, restorations, or licence type changes. Not another SRA directory scrape. Not Reglo / SwiftCase / VinciWorks seats. Not FCA FRN (different regulator). Not Companies House dissolution.

A1b (v9) — already PASS

Cited from opportunity/reports/phase3-a1b-next3-v9.md (do not invent competitors):

Field	Evidence
DIRECT SAME-JOB COMPETITORS	0 portfolio-change / SRA#-watchlist PPE products. Directory/lookup dumps (different job): crawlerbros/sra-solicitors-register-scraper (3 MAU / 7 tot); jungle_synthesizer/sra-solicitors-scraper (1 / 14).
EXTERNAL DEMAND	Reglo, SwiftCase, VinciWorks Omnitrack market SRA compliance seats (COLP/COFA dashboards, practising-certificate / authorisation tracking). SRA publishes a free Data Share API expressly for re-use (attribution required).
OUR WEDGE	SRA-number watchlist × scheduled Data Share API firm snapshot diff → typed authorisation/licence events only for the book.
Legal	GREEN — official SRA HTTP only; user-supplied free Azure APIM subscription key; required SRA attribution hyperlink; individual solicitor PII / disciplinary default OFF.

Honest coverage (read before buying)

Included (official Data Share API)	Not included
Firm / organisation AuthorisationStatus (YES / CONDITION / CEASE / INTERVENE)	HTML scrape of sra.org.uk Solicitors Register
Organisation type taxonomy (Authorised / Intervened / Closure*)	Reglo / SwiftCase / VinciWorks keys
Licence / authorisation type (RECBODY / LICBODY / RECSOLE …)	Nationwide newly-authorised firm lead dumps
Authorisation / status dates	Individual solicitor PII / disciplinary (default OFF)
Lookup by SRA# on your watchlist only	Scotland Law Society as primary; streaming / intra-day (refresh ~24h)

Live path: per-SRA# GET https://sra-prod-apim.azure-api.net/api/organisation/{SRANumber} with header Ocp-Apim-Subscription-Key (free SRA Data Share developer portal). Dataset refreshes ~every 24 hours. First observation stores a baseline (no charge). Quiet days ≈ $0 product charges. Respect API rate limits (SRA Technical Document); raise requestPaceMs on 429.

Value proposition

• SRA# watchlist × Data Share snapshot diff → SRA_FIRM_INTERVENTION, SRA_FIRM_CLOSED, SRA_FIRM_AUTHORISED_RESTORED, SRA_FIRM_STATUS_CHANGED, optional SRA_LICENCE_TYPE_CHANGED, SRA_FIRM_GONE.
• Official SRA HTTP only. No Reglo / SwiftCase key.
• Pay only for unique delivered change events. Durable KVS checkpoint + event_uid dedupe.

PRODUCTION USE (required for real monitoring)

Store default ≠ product. Schema defaults use sourceMode=fixture so Apify Store daily auto-tests leave a non-empty health dataset without calling SRA. That fixture path only writes a non-billable RUN_STATUS / FIXTURE_HEALTH row. It is not SRA monitoring.

For production monitoring you must:

1. Set sourceMode = live
2. Provide sraSubscriptionKey (free SRA APIM portal — Products → Datasharing → SRA Data Share API Version V1 → Subscribe)
3. Provide your sraNumbers watchlist
4. Schedule runs (daily is typical; Data Share is ~24h snapshot-class, not a stream)

Official references:

• SRA Information sharing / Data Share
• Developer portal
• Endpoint: https://sra-prod-apim.azure-api.net/api/organisation/{SRANumber}

Apify Store daily auto-test / default input

Field	Default
sraNumbers	["561658","400692"]
signalGroups	status, licence
sourceMode	fixture
emitFixtureDemoEvents	false
includeIndividuals	false
maxRunSeconds	55
requestPaceMs	300

On that path the Actor SUCCEEDS quickly, pushes exactly one RUN_STATUS / FIXTURE_HEALTH row (billable: false), and does not charge sra-firm-status-event-delivered.

Input (summary)

Field	Notes
sraNumbers	Watchlist (required, numeric SRA#)
signalGroups	status, licence
sourceMode	fixture (default) or live
sraSubscriptionKey	Required for live (isSecret)
emitFixtureDemoEvents	Default false
includeIndividuals	Default false (A5)
maxRunSeconds / maxEvents	Budgets
resumeFromCheckpoint	Default true
requestPaceMs	Default 300 (raise on 429)

Production example

{
  "sraNumbers": ["561658", "400692", "605001"],
  "signalGroups": ["status", "licence"],
  "sourceMode": "live",
  "sraSubscriptionKey": "<apim-subscription-key>",
  "asOfHint": "2026-09-17",
  "maxRunSeconds": 300,
  "requestPaceMs": 300,
  "resumeFromCheckpoint": true
}

Output

Change events (billable under PPE)

Typed rows include: sra_number, organisation_name, event_type, event_subtype, changed_fields, previous_value, new_value, as_of, evidence, summary, source_url, event_uid, licence_type, organisation_type, billable: true.

RUN_STATUS (never billed)

Every successful run pushes one health row (FIXTURE_HEALTH | MONITOR_IDLE | CATCHUP_COMPLETE | HEALTH_OK).

Pricing

Pay-per-event: sra-firm-status-event-delivered at $0.02 per delivered unique change event ($20 / 1,000). Single tier (see docs/monetization.md and ADR 0010). Health / baseline / duplicate / fixture rows are never charged. apify-actor-start ~$0.00005.

Local development

cd actors/uk-sra-firm-portfolio-status-monitor
npm install
npm test
npm run build
apify run -p

Attribution

UK SRA Firm Portfolio Status Monitor includes data supplied by the Solicitors Regulation Authority — attribution statement. Not an official SRA product. Not Reglo / SwiftCase. Status taxonomy stays faithful to SRA Data Share dictionary strings (YES / CONDITION / CEASE / INTERVENE and organisation-type classes). England & Wales SRA scope only.