ProfileResponse

Full company profile

  • ai
    Type: object

    AI-generated narrative summary of the business. Null when no summary has been generated.

    • summary
      Type: string

      AI-generated, plain-text description of the business, derived from the company's profile data. Internal display markup is stripped before it is returned. The whole ai section is omitted when no summary has been generated.

  • assessmentSuspended
    Type: object

    Present (non-null) when one or more assessment sections are deliberately withheld (suspended) — for example after an insolvency signal, or when the company is not actively trading. Explains why and which sections are affected. Null when nothing is suspended.

    • affectedSections
      Type: array string[]

      The union of every section withheld by any reason in reasons. Each name matches a top-level profile section whose current value is null because it is suspended. Currently one or both of riskOfFailure and creditCapacity.

    • reasons
      Type: array object[] · SuspensionReasonDetail[]

      One entry per distinct suspension reason, each listing the sections it withholds. Different reasons may affect different sections.

      A single assessment-suspension reason and the sections it affects

  • beneficialOwners
    Type: array object[] · BeneficialOwner[]

    Beneficial owners / persons with significant control (PSCs). Null when the beneficial-owners section is not available.

    A beneficial owner / person with significant control

    • isOrganization
      Type: boolean

      Whether the beneficial owner is an organization (true) rather than an individual person (false). Null when not known.

    • linkedProfileId
      Type: string

      Identifier of the owner's own profile in Grand's network, when Grand has matched the owner to a known entity. Can be used to look the owner up as a separate profile. Null when no match is known.

    • name
      Type: string

      Name of the beneficial owner — a person's full name, or the legal name of the owner when it is an organization.

    • nationality
      Type: string

      Declared nationality of the owner, as free text (not an ISO country code). Typically only present for individuals. Null when not disclosed.

    • ownership
      Type: string

      Ownership / control level, as free text from the source register. Typically a percentage band (e.g. 25-50%, 50-75%, 75-100%) rather than an exact figure. Null when not disclosed.

    • ownershipType
      Type: string

      The kind of interest the ownership figure describes, as free text from the source register (for example share ownership vs. voting rights). Null when not disclosed.

    • registrationNumber
      Type: string

      Company registration number of the owner, when the owner is an organization. Null for individuals or when not known.

    • relationship
      Type: string enum

      Nature of the owner's control over the company. Beneficial owners are typically recorded as BENEFICIAL_OWNER or POSC (person of significant control), but the full officer-role vocabulary can appear here. Null when the source register does not classify the relationship. One of:

      • BENEFICIAL_OWNER — a beneficial owner of the company.
      • POSC — a person of significant control.
      • DIRECTOR — a company director.
      • CORPORATE_DIRECTOR — a director that is a body corporate.
      • NOMINEE_DIRECTOR — a director acting as a nominee.
      • CORPORATE_NOMINEE_DIRECTOR — a corporate director acting as a nominee.
      • SECRETARY — a company secretary.
      • CORPORATE_SECRETARY — a corporate company secretary.
      • NOMINEE_SECRETARY — a secretary acting as a nominee.
      • CORPORATE_NOMINEE_SECRETARY — a corporate secretary acting as a nominee.
      • CIC_MANAGER — manager of a Community Interest Company.
      • LLP_DESIGNATED_MEMBER — a designated member of an LLP.
      • CORPORATE_LLP_DESIGNATED_MEMBER — a corporate designated member of an LLP.
      • LLP_MEMBER — a member of an LLP.
      • CORPORATE_LLP_MEMBER — a corporate member of an LLP.
      • MANAGER_OF_AN_EEIG — manager of a European Economic Interest Grouping.
      • CORPORATE_MANAGER_OF_AN_EEIG — a corporate manager of an EEIG.
      • MANAGING_OFFICER — managing officer of a registered overseas entity.
      • CORPORATE_MANAGING_OFFICER — a corporate managing officer of an overseas entity.
      • MEMBER_OF_A_MANAGEMENT_ORGAN — member of a UK Societas management organ.
      • CORPORATE_MEMBER_OF_A_MANAGEMENT_ORGAN — a corporate member of a management organ.
      • MEMBER_OF_A_SUPERVISORY_ORGAN — member of a UK Societas supervisory organ.
      • CORPORATE_MEMBER_OF_A_SUPERVISORY_ORGAN — a corporate member of a supervisory organ.
      • MEMBER_OF_AN_ADMINISTRATIVE_ORGAN — member of a UK Societas administrative organ.
      • CORPORATE_MEMBER_OF_AN_ADMINISTRATIVE_ORGAN — a corporate member of an administrative organ.
      • GENERAL_PARTNER — a general partner of a limited partnership.
      • LIMITED_PARTNER — a limited partner of a limited partnership.
      • PERSON_AUTHORISED_TO_ACCEPT — an overseas-company officer authorised to accept service.
      • PERSON_AUTHORISED_TO_REPRESENT — an overseas-company officer authorised to represent the company.
      • PERSON_AUTHORISED_TO_REPRESENT_AND_ACCEPT — authorised both to represent and to accept service.
      • RECEIVER_AND_MANAGER — a court/insolvency-appointed receiver and manager.
      • JUDICIAL_FACTOR — a court-appointed judicial factor.
      values
      • BENEFICIAL_OWNER
      • POSC
      • DIRECTOR
      • CORPORATE_DIRECTOR
      • NOMINEE_DIRECTOR
    • residence
      Type: string

      Declared country of residence of the owner, as free text. Typically only present for individuals. Null when not disclosed.

    • startDate
      Type: string Format: date-time

      Date on which the owner's control over the company commenced, as an ISO-8601 date-time. Null when not disclosed.

  • businessDetails
    Type: object

    Company identity and registration details: legal name, registration number, jurisdiction, legal form, incorporation date, registered address and SIC activity codes.

    • companyType
      Type: string enum

      Legal form of the entity. Null when the entity type is unknown.

      • SOLE_TRADER — sole trader.
      • PRIVATE_LIMITED_COMPANY — private company limited by shares (Ltd).
      • LIMITED_COMPANY — company limited by shares (generic).
      • LIMITED_BY_GUARANTEE — company limited by guarantee.
      • COMMUNITY_INTEREST_COMPANY — Community Interest Company (CIC).
      • UNLIMITED_COMPANY — unlimited company.
      • PUBLIC_LIMITED_COMPANY — Public Limited Company (PLC).
      • LIMITED_LIABILITY_PARTNERSHIP — Limited Liability Partnership (LLP).
      • LIMITED_PARTNERSHIP — Limited Partnership (LP).
      • SCOTTISH_LIMITED_PARTNERSHIP — Scottish Limited Partnership (SLP).
      • SECTION_30_EXEMPT — Section 30 exempt private company (rare variant).
      • CO_OPERATIVE_SOCIETY — co-operative society.
      • COMMUNITY_BENEFIT_SOCIETY — community benefit society.
      • CREDIT_UNION — credit union.
      • BUILDING_SOCIETY — building society.
      • FRIENDLY_SOCIETY — friendly society.
      • CIO — Charitable Incorporated Organisation.
      • SCIO — Scottish Charitable Incorporated Organisation.
      • UK_SOCIETAS — UK Societas (formerly European Company, SE).
      • CHARTERED_CORPORATION — chartered corporation.
      • STATUTORY_CORPORATION — statutory corporation.
      • CORPORATION_SOLE — corporation sole.
      • CORPORATION_BY_PRESCRIPTION — corporation by prescription.
      • OTHER — any other legal form.
      values
      • SOLE_TRADER
      • PRIVATE_LIMITED_COMPANY
      • LIMITED_COMPANY
      • LIMITED_BY_GUARANTEE
      • COMMUNITY_INTEREST_COMPANY
    • employees
      Type: integer Format: int32

      Reported employee count from the most recent filed accounts (average number of employees where available, otherwise the period-end headcount). Null when not reported.

    • incorporationDate
      Type: string Format: date-time

      Date the company was incorporated, as an ISO-8601 date-time. Null when unknown.

    • jurisdiction
      Type: string

      Jurisdiction of incorporation, as an ISO 3166-1 alpha-2 country code (e.g. GB for the United Kingdom, IE for Ireland).

    • legalName
      Type: string

      Registered legal name of the company.

    • previousNames
      Type: array string[]

      Former registered names the company has traded under. Null when none.

    • primarySicCode
      Type: string

      Primary Standard Industrial Classification (SIC) activity code — the company's main declared business activity. Null when not declared.

    • primarySicDescription
      Type: string

      Human-readable description of the primary SIC activity code. Null when not available.

    • registeredAddress
      Type: object · Address

      Registered office address, taken from the structured registered address on the most relevant source record. Null when no address is available.

    • registrationNumber
      Type: string

      Company registration number in its home registry (for UK companies, the Companies House number).

    • sicCodes
      Type: array object[] · SicCode[]

      All declared SIC industry-classification codes for the company (including the primary one). Null when none are declared.

      SIC industry classification code

  • compliance
    Type: object

    Anti-money-laundering (AML) screening results across PEP, sanctions/watchlists and adverse-media checks, for both the entity and its directors/PSCs. Null when no compliance screening is available.

    • directorsAndPscs
      Type: object · ComplianceSection

      AML screening (PEP, sanctions/watchlists and adverse media) run against the company's directors and persons with significant control (PSCs). Null when directors & PSC screening is unavailable.

    • entity
      Type: object · ComplianceSection

      AML screening (PEP, sanctions/watchlists and adverse media) run against the company itself. Null when entity screening is unavailable.

  • corporateStructure
    Type: object

    The corporate group this company belongs to — ultimate parent, immediate parent and the flat list of group members. Null when no group structure is known.

    • hierarchy
      Type: array object[] · StructureNode[]

      Flat list of every entity in the corporate group. Each node carries the ids of its direct children, so the tree can be reconstructed from this list. Null when no group hierarchy is available.

      A company within the corporate group

    • immediateParent
      Type: object · StructureNode

      The company's immediate (direct) parent company. Null when the company has no known direct parent or is itself the group head.

    • ownershipStatus
      Type: string enum

      Whether the company is wholly or partially owned within its group. Null when the ownership status is not known. One of:

      • WHOLLY_OWNED — the company is wholly owned within the group.
      • PARTIALLY_OWNED — the company is only partially owned within the group.
      values
      • WHOLLY_OWNED
      • PARTIALLY_OWNED
    • ultimateParent
      Type: object · StructureNode

      The ultimate parent at the head of the corporate group (the entity not owned by any other entity in the hierarchy). Null when the company is not part of a known group or the group head cannot be determined.

  • courts
    Type: array object[] · Court[]

    Court cases / litigation sourced from Caseboard. Null when no court cases are present.

    A court case against or involving the company

    • active
      Type: boolean

      Whether the underlying source case is still considered active. true (or null) indicates the case is open; false indicates it has been closed (e.g. withdrawn, dismissed, succeeded or transferred), in which case status describes how.

    • caseNumber
      Type: string

      Court case reference number, parsed from the source case description. May be null if the source description contains no recognisable reference.

    • category
      Type: string

      Free-text description of the case, taken from the source note or raw case description (e.g. the nature of the proceedings).

    • court
      Type: string

      Name of the court handling the case, where known.

    • dateFiled
      Type: string Format: date-time

      Date the case was filed / the notice was dated, as an ISO-8601 date-time (UTC). May be null if unknown.

    • status
      Type: string

      Free-text status of the case as reported by the source (Caseboard), describing its current state. Not drawn from a fixed set of values. May be null.

    • title
      Type: string

      Title of the case — typically the name of the company or party the case is brought against.

    • type
      Type: string enum

      The classified type of the underlying court notice. One of:

      • ACCOUNTS — a notice relating to the filing of accounts.
      • ADDRESS — a change of registered office address.
      • ADMINISTRATION — the company entering administration.
      • ANNUAL_RETURN — an annual return / confirmation statement notice.
      • CAPITAL — a change in share capital.
      • CCJ — a County Court Judgment.
      • CHANGE_OF_NAME — a change of the company name.
      • COURT_FILING — a general court filing not covered by a more specific type.
      • DISSOLUTION — dissolution of the company.
      • INCORPORATION — incorporation of the company.
      • LIQUIDATION — the company being wound up / liquidated.
      • MISCELLANEOUS — a notice that does not fit the other categories.
      • MORTGAGE — a charge / mortgage notice.
      • OFFICERS — a change of officers (directors / secretaries).
      • RESOLUTION — a company resolution.
      • STRIKE_OFF — the company being struck off the register.
      values
      • ACCOUNTS
      • ADDRESS
      • ADMINISTRATION
      • ANNUAL_RETURN
      • CAPITAL
    • url
      Type: string

      Link to the case at the source, if available.

  • creditCapacity
    Type: object

    How much monthly trade credit the company can support, derived from its financial data. Null while still being computed (then listed in pendingSections as creditCapacity); the current limit is also withheld when this section is suspended (see assessmentSuspended).

    • effectiveDate
      Type: string Format: date-time

      Timestamp (ISO-8601) at which the current credit-capacity assessment last changed.

    • history
      Type: array object[] · CreditCapacityHistory[]

      Prior credit-capacity assessments, letting you track how the recommended limit has moved over time.

      A point in the credit-capacity history

    • reasons
      Type: array object[] · StructuredReason[]

      Human-readable drivers behind the current credit-capacity outcome. null when the assessment is suspended.

      A structured factor contributing to a section's assessment

    • recommended
      Type: object · CreditLimit

      Recommended credit limit, given as both a monthly figure and its yearly equivalent. Zero when status is NOT_RECOMMENDED, and null when the assessment is suspended.

    • status
      Type: object · CreditCapacityStatusenum

      Outcome of the credit-capacity assessment. null when the assessment is suspended (e.g. the company is not actively trading or an insolvency event was recorded) — in that case the reason is reported in the top-level assessmentSuspended section. One of:

      • AVAILABLE — a non-zero credit limit is recommended; see recommended.
      • NOT_RECOMMENDED — extending credit is not recommended; recommended is zero.
      values
      • AVAILABLE

        A credit limit is recommended (the amounts are populated).

      • NOT_RECOMMENDED

        Credit is not recommended --- the limits are zero.

  • directors
    Type: array object[] · Director[]

    Directors and secretaries, both currently appointed and previous. Null when the directors section is not available.

    A director or company secretary

    • active
      Type: boolean

      Whether the appointment is current. true when there is no resignation date (i.e. resignedDate is null), false otherwise.

    • address
      Type: string

      Single-line service / correspondence address for the officer (not necessarily a residential address). Null when not disclosed.

    • appointedDate
      Type: string Format: date-time

      Date the officer was appointed, as an ISO-8601 date-time. Null when the appointment date is not held.

    • birthMonth
      Type: integer Format: int32

      Month of birth as a number from 1 (January) to 12 (December). Null when the date of birth is not held.

    • birthYear
      Type: integer Format: int32

      Year of birth. Date of birth is exposed as month and year only, matching Companies House public disclosure (the exact day is never published). Null when the date of birth is not held.

    • name
      Type: string

      Full legal name of the appointed officer, as filed at the register.

    • nationality
      Type: string

      Declared nationality, as free text from the source register (not an ISO country code). Null when not disclosed.

    • occupation
      Type: string

      Declared occupation of the officer, as free text. Null when not disclosed.

    • residence
      Type: string

      Declared country of residence, as free text from the source register. Null when not disclosed.

    • resignedDate
      Type: string Format: date-time

      Date the officer resigned or was otherwise removed, as an ISO-8601 date-time. Null while the appointment is still current.

    • role
      Type: string enum

      The officer's appointed role. This list holds directors and company secretaries (and equivalent governance roles for non-company entity types such as LLPs, limited partnerships and overseas entities). Null when the source register does not classify the role. One of:

      • DIRECTOR — a company director.
      • CORPORATE_DIRECTOR — a director that is itself a body corporate.
      • NOMINEE_DIRECTOR — a director acting as a nominee for another party.
      • CORPORATE_NOMINEE_DIRECTOR — a corporate director acting as a nominee.
      • SECRETARY — a company secretary.
      • CORPORATE_SECRETARY — a company secretary that is a body corporate.
      • NOMINEE_SECRETARY — a secretary acting as a nominee.
      • CORPORATE_NOMINEE_SECRETARY — a corporate secretary acting as a nominee.
      • CIC_MANAGER — manager of a Community Interest Company.
      • LLP_DESIGNATED_MEMBER — a designated member of an LLP.
      • CORPORATE_LLP_DESIGNATED_MEMBER — a corporate designated member of an LLP.
      • LLP_MEMBER — a member of an LLP.
      • CORPORATE_LLP_MEMBER — a corporate member of an LLP.
      • MANAGER_OF_AN_EEIG — manager of a European Economic Interest Grouping.
      • CORPORATE_MANAGER_OF_AN_EEIG — a corporate manager of an EEIG.
      • MANAGING_OFFICER — managing officer of a registered overseas entity.
      • CORPORATE_MANAGING_OFFICER — a corporate managing officer of an overseas entity.
      • MEMBER_OF_A_MANAGEMENT_ORGAN — member of the management organ of a UK Societas.
      • CORPORATE_MEMBER_OF_A_MANAGEMENT_ORGAN — a corporate member of a management organ.
      • MEMBER_OF_A_SUPERVISORY_ORGAN — member of the supervisory organ of a UK Societas.
      • CORPORATE_MEMBER_OF_A_SUPERVISORY_ORGAN — a corporate member of a supervisory organ.
      • MEMBER_OF_AN_ADMINISTRATIVE_ORGAN — member of the administrative organ of a UK Societas.
      • CORPORATE_MEMBER_OF_AN_ADMINISTRATIVE_ORGAN — a corporate member of an administrative organ.
      • GENERAL_PARTNER — a general partner of a limited partnership.
      • LIMITED_PARTNER — a limited partner of a limited partnership.
      • PERSON_AUTHORISED_TO_ACCEPT — an overseas-company officer authorised to accept service.
      • PERSON_AUTHORISED_TO_REPRESENT — an overseas-company officer authorised to represent the company.
      • PERSON_AUTHORISED_TO_REPRESENT_AND_ACCEPT — authorised both to represent and to accept service.
      • RECEIVER_AND_MANAGER — a court/insolvency-appointed receiver and manager.
      • JUDICIAL_FACTOR — a court-appointed judicial factor.
      • BENEFICIAL_OWNER — a beneficial owner (rarely surfaced here; see the beneficial owners list).
      • POSC — a person of significant control (rarely surfaced here; see the beneficial owners list).
      values
      • DIRECTOR
      • CORPORATE_DIRECTOR
      • NOMINEE_DIRECTOR
      • CORPORATE_NOMINEE_DIRECTOR
      • SECRETARY
  • earlySignals
    Type: array object[] · EarlySignal[]

    Active forward-looking early-warning signals currently in effect. Null when there are none.

    A forward-looking early-warning signal

    • details
      Type: string

      Fuller, multi-sentence description explaining what the signal means, its typical implications, and when it is expected to resolve.

    • eventDate
      Type: string Format: date-time

      Timestamp (ISO-8601) at which the underlying event occurred.

    • evidenceLink
      Type: string

      URL to the underlying evidence for this signal (e.g. the court case page, the Companies House filing, or the Gazette notice). Null when no direct link is available.

    • expiryDate
      Type: string Format: date-time

      Timestamp (ISO-8601) at which this signal expires and is no longer shown.

    • explanation
      Type: string

      One-line, human-readable summary of the signal, generated with specific context (e.g. which filing is due and by when).

    • firstSeenDate
      Type: string Format: date-time

      Timestamp (ISO-8601) at which Grand first detected this signal.

    • retirementReason
      Type: string

      The condition under which this signal will be (or was) retired, when applicable.

    • source
      Type: string enum

      The data source this signal was derived from, normalised to the four public API-level sources. One of:

      • COMPANIES_HOUSE — sourced from Companies House (registry filings, officer data, etc.).
      • GAZETTE — sourced from The Gazette (official UK public record — insolvency notices, etc.).
      • REGISTRY_TRUST — sourced from Registry Trust (County Court Judgments and other debt registry records).
      • GRAND — Grand-derived or Grand-curated; catch-all for non-authoritative sources including court filings, news/press, and manual overrides.
      values
      • COMPANIES_HOUSE
      • GAZETTE
      • REGISTRY_TRUST
      • GRAND
    • type
      Type: string enum

      The kind of early-warning signal. These are credible, pre-threshold indicators; they never by themselves change the company's trading status. One of:

      • FILING_TRAJECTORY — short-term deterioration in statutory filing position (filings due within 30 days).
      • OVERDUE_FILINGS — statutory filing obligations are overdue but not yet determining trading status.
      • COURT_CASE_FILED — fallback for an unrecognised court notice that does not match a known category.
      • NEW_CCJ — a new County Court Judgment has been registered against the company.
      • RESOLVED_CCJ — a previously registered CCJ has been settled or satisfied.
      • WINDING_UP_PETITION_FILED — a creditor (often HMRC) has applied to compulsorily liquidate the company.
      • APPOINTMENT_OF_ADMINISTRATOR — an administration filing has been made at court, or the appointment has been confirmed in the Gazette.
      • APPOINTMENT_OF_RECEIVER — a secured lender is enforcing a charge over company assets via a receiver.
      • PROPERTY_CHARGE_ENFORCEMENT — assets have been seized or realised to repay secured debt.
      • FAILURE_TO_FILE_ACCOUNTS — escalated statutory non-compliance beyond routine overdue filings (Gazette notice).
      • OFFICER_UBO_CHANGE — a change to a registered officer or person with significant control.
      • ENTITY_TYPE_CHANGE — a change to the registered legal entity type at Companies House.
      • BUSINESS_DETAILS_CHANGE — a change to the registered business name, address, or other core details.
      • SIC_CODE_CHANGE — a change to one or more registered SIC codes.
      • FILING_SCHEDULE_CHANGED — a change to the statutory filing schedule or accounting reference date.
      • MATERIAL_NEWS_EVENT — credible reporting or announcements indicating a potentially material company event.
      values
      • FILING_TRAJECTORY
      • OVERDUE_FILINGS
      • COURT_CASE_FILED
      • NEW_CCJ
      • RESOLVED_CCJ
  • earlySignalsHistory
    Type: array object[] · EarlySignal[]

    Early-warning signals that have been retired, expired or superseded. Null when there are none.

    A forward-looking early-warning signal

    • details
      Type: string

      Fuller, multi-sentence description explaining what the signal means, its typical implications, and when it is expected to resolve.

    • eventDate
      Type: string Format: date-time

      Timestamp (ISO-8601) at which the underlying event occurred.

    • evidenceLink
      Type: string

      URL to the underlying evidence for this signal (e.g. the court case page, the Companies House filing, or the Gazette notice). Null when no direct link is available.

    • expiryDate
      Type: string Format: date-time

      Timestamp (ISO-8601) at which this signal expires and is no longer shown.

    • explanation
      Type: string

      One-line, human-readable summary of the signal, generated with specific context (e.g. which filing is due and by when).

    • firstSeenDate
      Type: string Format: date-time

      Timestamp (ISO-8601) at which Grand first detected this signal.

    • retirementReason
      Type: string

      The condition under which this signal will be (or was) retired, when applicable.

    • source
      Type: string enum

      The data source this signal was derived from, normalised to the four public API-level sources. One of:

      • COMPANIES_HOUSE — sourced from Companies House (registry filings, officer data, etc.).
      • GAZETTE — sourced from The Gazette (official UK public record — insolvency notices, etc.).
      • REGISTRY_TRUST — sourced from Registry Trust (County Court Judgments and other debt registry records).
      • GRAND — Grand-derived or Grand-curated; catch-all for non-authoritative sources including court filings, news/press, and manual overrides.
      values
      • COMPANIES_HOUSE
      • GAZETTE
      • REGISTRY_TRUST
      • GRAND
    • type
      Type: string enum

      The kind of early-warning signal. These are credible, pre-threshold indicators; they never by themselves change the company's trading status. One of:

      • FILING_TRAJECTORY — short-term deterioration in statutory filing position (filings due within 30 days).
      • OVERDUE_FILINGS — statutory filing obligations are overdue but not yet determining trading status.
      • COURT_CASE_FILED — fallback for an unrecognised court notice that does not match a known category.
      • NEW_CCJ — a new County Court Judgment has been registered against the company.
      • RESOLVED_CCJ — a previously registered CCJ has been settled or satisfied.
      • WINDING_UP_PETITION_FILED — a creditor (often HMRC) has applied to compulsorily liquidate the company.
      • APPOINTMENT_OF_ADMINISTRATOR — an administration filing has been made at court, or the appointment has been confirmed in the Gazette.
      • APPOINTMENT_OF_RECEIVER — a secured lender is enforcing a charge over company assets via a receiver.
      • PROPERTY_CHARGE_ENFORCEMENT — assets have been seized or realised to repay secured debt.
      • FAILURE_TO_FILE_ACCOUNTS — escalated statutory non-compliance beyond routine overdue filings (Gazette notice).
      • OFFICER_UBO_CHANGE — a change to a registered officer or person with significant control.
      • ENTITY_TYPE_CHANGE — a change to the registered legal entity type at Companies House.
      • BUSINESS_DETAILS_CHANGE — a change to the registered business name, address, or other core details.
      • SIC_CODE_CHANGE — a change to one or more registered SIC codes.
      • FILING_SCHEDULE_CHANGED — a change to the statutory filing schedule or accounting reference date.
      • MATERIAL_NEWS_EVENT — credible reporting or announcements indicating a potentially material company event.
      values
      • FILING_TRAJECTORY
      • OVERDUE_FILINGS
      • COURT_CASE_FILED
      • NEW_CCJ
      • RESOLVED_CCJ
  • eventHistory
    Type: array object[] · EventHistoryItem[]

    Chronological history of filings and notices (Companies House, Gazette, Caseboard), newest first. Null when no events are present.

    A dated event in the company's filing/notice history

    • date
      Type: string Format: date-time

      Timestamp (ISO-8601) on which this event occurred.

    • description
      Type: string

      Human-readable description of the event, taken from the notice's note or its raw description.

    • source
      Type: string enum

      The data source this event was derived from, normalised to the four public API-level sources. One of:

      • COMPANIES_HOUSE — sourced from Companies House (registry filings, officer data, etc.).
      • GAZETTE — sourced from The Gazette (official UK public record — insolvency notices, etc.).
      • REGISTRY_TRUST — sourced from Registry Trust (County Court Judgments and other debt registry records).
      • GRAND — Grand-derived or Grand-curated; catch-all for non-authoritative sources including court filings, news/press, and manual overrides.
      values
      • COMPANIES_HOUSE
      • GAZETTE
      • REGISTRY_TRUST
      • GRAND
    • type
      Type: string enum

      The category of event/notice. One of:

      • ACCOUNTS — annual accounts filing.
      • ADDRESS — registered office address change.
      • ADMINISTRATION — administration-related notice.
      • ANNUAL_RETURN — annual return / confirmation statement.
      • CAPITAL — share capital change.
      • CCJ — County Court Judgment.
      • CHANGE_OF_NAME — company name change.
      • COURT_FILING — a court filing.
      • DISSOLUTION — dissolution notice.
      • INCORPORATION — company incorporation.
      • LIQUIDATION — liquidation notice.
      • MISCELLANEOUS — an event that does not fit another category.
      • MORTGAGE — a mortgage or charge.
      • OFFICERS — a change to officers (directors, secretaries).
      • RESOLUTION — a filed resolution.
      • STRIKE_OFF — a strike-off (removal from the register) notice.
      values
      • ACCOUNTS
      • ADDRESS
      • ADMINISTRATION
      • ANNUAL_RETURN
      • CAPITAL
    • url
      Type: string

      URL to the underlying record for this event, when one is available.

  • filings
    Type: object

    Coherence and consistency of the company's statutory filings and how reliably they can be interpreted, plus annual-accounts and confirmation-statement due status. Null while still being computed, in which case pendingSections contains filings.

    • accounts
      Type: object · AccountsFiling

      Annual-accounts filing detail: last-filed and next-due dates, overdue flag, accounts type, and audit/dormant characteristics. Null when unavailable.

    • confirmationStatement
      Type: object · FilingDue

      Confirmation-statement filing status: when it was last filed, when the next is due, and whether it is overdue. Null when unavailable.

    • effectiveDate
      Type: string Format: date-time

      When the current filing-health status took effect, as an ISO-8601 date-time. Derived from the most recent history entry; null when no history exists.

    • history
      Type: array object[] · FilingBehaviourHistory[]

      Prior filing-behaviour values over time, newest first. Null when no history is recorded.

      A point in the filing-behaviour history

    • reasons
      Type: array object[] · StructuredReason[]

      Structured drivers behind the current filing-health assessment. Null when none are recorded.

      A structured factor contributing to a section's assessment

    • status
      Type: string enum

      Whether the company's statutory accounts are coherent and interpretable. Null when unknown.

      • CONSISTENT — accounts are complete and internally consistent for the filing regime.
      • INCONSISTENT — accounts are incomplete or internally inconsistent.
      • UNABLE_TO_ASSESS — insufficient data to determine filing health (e.g. no filings, or a young company).
      values
      • CONSISTENT
      • INCONSISTENT
      • UNABLE_TO_ASSESS
  • financials
    Type: object

    Filed financial accounts, one statement per accounting period, ordered most recent first. Null when no financial reports are available.

    • accountingReferenceDate
      Type: string

      The company's accounting reference date (ARD) — the day and month its financial year ends, as recorded at Companies House. Formatted DD/MM. Null when not reported.

    • currency
      Type: string

      ISO 4217 currency code that the filed accounts are reported in, taken from the most recent statement. For UK Companies House filings this is effectively always GBP; defaults to GBP when no statements are present.

    • mostRecentAccountsDate
      Type: string Format: date-time

      The 'made up to' date of the most recent filed accounts — i.e. the period-end date of the latest statement on file. Null when no accounts have been filed.

    • mostRecentFilingType
      Type: string enum

      The accounts type of the most recent filing, indicating the reporting regime and level of detail disclosed. Companies filing under small-company, micro-entity or exemption regimes typically disclose sparse profit & loss detail. Null when not reported.

      • STANDARD — standard accounts.
      • GROUP — group (consolidated) accounts.
      • FULL — full accounts.
      • SMALL — small-company accounts.
      • MEDIUM — medium-company accounts.
      • DORMANT — dormant-company accounts.
      • INTERIM — interim accounts.
      • INITIAL — initial accounts.
      • TOTAL_EXEMPTION_FULL — full accounts filed under total exemption.
      • TOTAL_EXEMPTION_SMALL — small accounts filed under total exemption.
      • PARTIAL_EXEMPTION — accounts filed under partial exemption.
      • AUDIT_EXEMPTION_SUBSIDIARY — subsidiary accounts filed under audit exemption.
      • FILING_EXEMPTION_SUBSIDIARY — subsidiary accounts filed under filing exemption.
      • MICRO_ENTITY — micro-entity accounts.
      • NO_ACCOUNTS_TYPE_AVAILABLE — accounts filed but type could not be determined.
      • NO_FILINGS — the company has never filed any accounts with Companies House.
      • AUDITED_ABRIDGED — audited abridged accounts.
      • UNAUDITED_ABRIDGED — unaudited abridged accounts.
      • UNKNOWN — filing type not recognised.
      values
      • STANDARD
      • GROUP
      • FULL
      • SMALL
      • MEDIUM
    • nextAccountsDue
      Type: string Format: date-time

      The Companies House due date by which the company's next annual accounts must be filed. Null when not known.

    • statements
      Type: array object[] · FinancialStatement[]

      The filed accounts, one entry per accounting period, ordered most-recent period first. Null when no statements are available.

      Accounts for one accounting period

  • legalNotices
    Type: object

    Adverse legal events: County Court Judgments (CCJs), London/Edinburgh/Belfast Gazette notices and registered charges. Null when none are present.

    • charges
      Type: array object[] · Charge[]

      Charges and mortgages registered as security against the company. This field is part of the response contract but is not yet sourced on the profile, so it is currently always an empty array.

      A registered charge / mortgage against the company

    • gazetteNotices
      Type: array object[] · GazetteNotice[]

      Notices published against the company in the official UK Gazette (e.g. insolvency, strike-off and dissolution notices). null when no Gazette notices are present on the profile.

      A UK Gazette notice

    • judgments
      Type: array object[] · Judgment[]

      Court judgments recorded against the company, such as County Court Judgments (CCJs) sourced from Registry Trust. null when no judgment data is present on the profile; otherwise an array (possibly empty).

      A court judgment against the company

  • pendingSections
    Type: array string[]

    Names of sections still being computed and therefore null in this response; poll the endpoint again shortly to obtain them. Possible values are status, filings, riskOfFailure and creditCapacity. Empty when everything is ready.

  • riskOfFailure
    Type: object

    Likelihood of financial distress or business failure within the next 12 months. Null while still being computed (then listed in pendingSections as riskOfFailure); the current score is also withheld when this section is suspended (see assessmentSuspended).

    • effectiveDate
      Type: string Format: date-time

      Timestamp (ISO-8601) at which the current risk assessment last changed.

    • history
      Type: array object[] · RiskOfFailureHistory[]

      Prior risk-of-failure assessments, letting you track how the risk band has moved over time.

      A point in the risk-of-failure history

    • level
      Type: string enum

      Risk band for the company, derived from probabilityOfDefault using fixed thresholds. null when the assessment is suspended (e.g. an insolvency signal or the company is not actively trading) — in that case the reason is reported in the top-level assessmentSuspended section. One of:

      • LOW — probability of default below 0.05 (under 5%).
      • LOW_MEDIUM — probability of default from 0.05 to under 0.10 (5–10%).
      • MEDIUM — probability of default from 0.10 to under 0.15 (10–15%).
      • MEDIUM_HIGH — probability of default from 0.15 to under 0.25 (15–25%).
      • HIGH — probability of default of 0.25 or above (25%+).
      • UNABLE_TO_ASSESS — insufficient data to produce an assessment (e.g. a recently incorporated company with no filing history).
      values
      • LOW
      • LOW_MEDIUM
      • MEDIUM
      • MEDIUM_HIGH
      • HIGH
      • UNABLE_TO_ASSESS
    • probabilityOfDefault
      Type: number Format: double
      min:  
      0
      max:  
      1

      Estimated probability that the company fails within the next 12 months, as a decimal from 0.0 to 1.0 (i.e. 0–100%). null when the assessment is suspended or when there is insufficient data (level = UNABLE_TO_ASSESS).

    • reasons
      Type: array object[] · StructuredReason[]

      Human-readable drivers behind the current risk assessment. null when the assessment is suspended.

      A structured factor contributing to a section's assessment

  • status
    Type: object

    Grand's assessed trading status — whether the company is actively operating, inactive, or in a formal insolvency or closure process — with the reasons behind it and prior values. Null while still being computed, in which case pendingSections contains status.

    • effectiveDate
      Type: string Format: date-time

      When the current trading status last changed, as an ISO-8601 date-time. Null when unknown.

    • grandStatus
      Type: string enum

      Grand's assessed trading status. Named grandStatus to leave room for future legalStatus / operatingStatus dimensions alongside it. Values are precedence-ordered — terminal and insolvency states take priority over active/inactive. One of:

      • ACTIVELY_TRADING — operating normally, no adverse status.
      • INACTIVE — no evidence of current trading activity (inferred).
      • STRIKE_OFF_INITIATED — a strike-off (removal from the register) process has begun.
      • IN_ADMINISTRATION — under a formal administration insolvency process.
      • IN_LIQUIDATION — being wound up; assets are being liquidated.
      • OVERSEAS_ENTITY — a registered overseas entity, still active.
      • DISSOLVED — dissolved and removed from the register (terminal).
      • CONVERTED_CLOSED — closed after converting to another entity type (terminal).
      • REMOVED — removed from the register (terminal).
      • CLOSED_OVERSEAS_ENTITY — a closed overseas entity (terminal).
      values
      • ACTIVELY_TRADING
      • INACTIVE
      • STRIKE_OFF_INITIATED
      • IN_LIQUIDATION
      • IN_ADMINISTRATION
    • history
      Type: array object[] · TradingStatusHistory[]

      Prior trading-status values over time, each with its own effective date and reasons. Null when no history is recorded.

      A point in the trading-status history

    • reasons
      Type: array object[] · StructuredReason[]

      Structured drivers behind the current trading status (e.g. the specific registry events that determined it). Null when no reasons are recorded.

      A structured factor contributing to a section's assessment

  • structure
    Type: object

    Company composition — size, complexity and maturity — assessed in relation to its declared business activity. Null when the structure section is not available.

    • complexity
      Type: string enum

      Corporate-structure complexity, scored from factors such as group structure, directors and shareholders. May be null when the structure section has not been computed.

      • STANDARD — simple to moderate organisational structure.
      • ELEVATED — complex organisational structure.
      • HIGH — high to extreme complexity.
      • UNAVAILABLE — complexity could not be determined (missing data or a calculation error).
      values
      • STANDARD
      • ELEVATED
      • HIGH
      • UNAVAILABLE
    • maturity
      Type: string enum

      Maturity stage, classified purely from the number of years since incorporation. May be null when the structure section has not been computed.

      • YOUNG — less than 2 years since incorporation.
      • EARLY_STAGE — 2–4 years since incorporation.
      • ESTABLISHED — 4–10 years since incorporation.
      • MATURE — 10 or more years since incorporation.
      values
      • YOUNG
      • EARLY_STAGE
      • ESTABLISHED
      • MATURE
    • size
      Type: string enum

      Size band, following UK Companies House (Companies Act 2006) thresholds. Taken from the most recent accounts filing type when it is decisive (e.g. micro-entity or small-company accounts); otherwise classified from financials using turnover when available, falling back to balance-sheet total assets (employee count is not used). May be null when the structure section has not been computed.

      • MICRO — turnover ≤ £632k, or (no turnover) total assets ≤ £316k.
      • SMALL — turnover ≤ £15M, or total assets ≤ £7.5M.
      • MEDIUM — turnover ≤ £54M, or total assets ≤ £27M.
      • LARGE — turnover above £54M (or total assets above £27M).
      • UNAVAILABLE — no filing type or financial data is available to resolve a size band.
      • LOADING — financial data is still being loaded; the size will be calculated once it arrives.
      values
      • MICRO
      • SMALL
      • MEDIUM
      • LARGE
      • UNAVAILABLE
      • LOADING
    • yearsInBusiness
      Type: integer Format: int32

      Whole number of years since incorporation, the same value the maturity band is derived from. Null when the maturity classification is unavailable.

Grand Public API