@spec advanced_search(
  KYCCentral.t(),
  keyword()
) :: result()

Structured company search with status, type, SIC and date filters.

Options

All optional. Dates are YYYY-MM-DD. List options are repeatable, so company_status: ["active", "liquidation"] matches either.

• :company_name_includes, :company_name_excludes
• :company_status, :company_type, :sic_codes — lists
• :location
• :incorporated_from, :incorporated_to
• :dissolved_from, :dissolved_to
• :size, :start_index, :items_per_page

@spec charge(KYCCentral.t(), String.t(), String.t()) :: result()

One charge in full, including the persons entitled to it.

@spec charges(KYCCentral.t(), String.t()) :: result()

Registered charges (secured debt) against the company.

@spec disqualifications(KYCCentral.t(), String.t()) :: result()

Disqualified-director records across the company's officers.

@spec dossier(KYCCentral.t(), String.t()) :: result()

Profile, officers, PSCs, charges, insolvency and filings in one call.

Cheaper than issuing each lookup separately — one request against your rate limit instead of six.

@spec filing_extract(KYCCentral.t(), String.t(), String.t()) :: result()

Structured data parsed out of one filing.

Requires an active Professional subscription.

@spec filing_history(KYCCentral.t(), String.t(), keyword()) :: result()

Filing history. Requires an active Professional subscription.

Options

• :category — Companies House filing category, e.g. "accounts", "confirmation-statement", "officers".
• :items_per_page, :start_index

@spec get(KYCCentral.t(), String.t()) :: result()

The company profile: name, status, type, dates, address, SIC codes.

@spec insolvency(KYCCentral.t(), String.t()) :: result()

Insolvency cases. Returns an empty payload when there are none.

@spec officer_appointments(KYCCentral.t(), String.t(), keyword()) :: result()

Every appointment held by one officer, across all companies.

@spec officer_disqualification(KYCCentral.t(), String.t(), String.t()) :: result()

Disqualification record for one officer of this company.

@spec officers(KYCCentral.t(), String.t()) :: result()

Appointed officers, including resigned ones.

@spec psc_chain_depth(KYCCentral.t(), String.t()) :: result()

How many corporate layers sit between the company and a real person.

@spec psc_chain_tree(KYCCentral.t(), String.t()) :: result()

The full ownership chain as a tree, resolving corporate PSCs upwards.

@spec psc_statements(KYCCentral.t(), String.t()) :: result()

PSC statements — the register's explanations for an absent PSC.

@spec pscs(KYCCentral.t(), String.t()) :: result()

Registered beneficial owners (PSCs).

@spec search(KYCCentral.t(), String.t(), keyword()) :: result()

Search companies by name or number.

Options

• :items_per_page — page size. The API applies its own default and cap.
• :start_index — zero-based offset for paging.

@spec search_officers(KYCCentral.t(), String.t(), keyword()) :: result()

Search officers (directors, secretaries) by name across all companies.

@spec statement_of_capital(KYCCentral.t(), String.t()) :: result()

Share capital and shareholders from the latest confirmation statement.

Requires an active Professional subscription.