LifestylePlatform secret

UK Companies House

company-information.service.gov.uk

UK company registry search and profile data provider.

Tier: 🥉 Bronze
Reward: ₩15,000
Auth: Platform secret
Operations: 3
Working now: 0 contributors
Status: Open

Scope

Exposes the UK company registry. Callers search registered companies, read company profiles with status and registered office, and list current officers with their roles.

Expected operations

search-companiesSearch companiesreadDifficulty: easy

Return registered companies matching a name query, with company numbers and registration status.

Inputs

querystringrequired

Suggested surface — propose changes in your submission if the upstream differs.

Acceptance criteria

Provider scaffolded from the public @apifuse/provider-sdk
All listed operations implemented with Zod/Standard Schema input & output
Each operation declares exactly one of healthCheck or healthCheckUnsupported
Real upstream fixture data included where applicable
bun run check and bun run test pass
Auth, credential, and env-secret behavior documented (no real secrets committed)

Evidence to submit

Workspace repository and main commit link
SDK version/tag and the create command used
Operation list with input/output summaries
Health coverage table per operation
bun run check and bun run test output

Ready to claim?

Submit a claim. Your workspace will be prepared after confirmation.

Claiming a bounty requires a GitHub sign-in.

Outputs

companiescompany_numbercompany_namecompany_statuscompany_typeincorporated_onregistered_office_addresstotal_count

Acceptance

Company numbers are the registry's canonical identifiers accepted by the profile and officers operations.
Dissolved companies remain searchable with their dissolved status visible instead of being filtered out silently.

Auth required for this operation.

get-company-profileGet company profilereadDifficulty: easy

Return the full registry profile for one company, including status, SIC codes, accounts due dates, and registered office.

Inputs

company_numberstringrequired
Company registration number
09446231

Outputs

company_numbercompany_namecompany_statuscompany_typeincorporated_onsic_codes

list-company-officersList company officersreadDifficulty: medium

Return officers of one company with their roles, appointment dates, and resignation dates where applicable.

Inputs

company_numberstringrequired
Company registration number
09446231
active_onlybooleanoptional
Restrict to currently appointed officers
true

Outputs

company_numberofficersofficer_nameofficer_roleappointed_onresigned_on