FilingBehaviour

Coherence and consistency of the company's statutory filings, and how reliably they can be interpreted.

  • accounts
    Type: object

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

    • audited
      Type: boolean

      Whether the most recent accounts were audited. Null when not known.

    • auditorName
      Type: string

      Name of the auditor on the latest accounts. Null when the company is unaudited or the auditor is not known.

    • dormant
      Type: boolean

      Whether the company is dormant (not trading and filing dormant-company accounts). Null when not known.

    • dueOn
      Type: string Format: date-time

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

    • filingType
      Type: string enum

      The accounts type of the company's filing, indicating the reporting regime and level of 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
    • lastFiled
      Type: string Format: date-time

      Date the most recent annual accounts were filed with Companies House. Null when not known or never filed.

    • overdue
      Type: boolean

      Whether the annual accounts are currently overdue (past their due date and not yet filed). Null when not known.

  • confirmationStatement
    Type: object

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

    • dueOn
      Type: string Format: date-time

      When the next instance of this filing is due, as an ISO-8601 date-time. Null when no due date is known.

    • lastFiled
      Type: string Format: date-time

      When this filing was most recently made, as an ISO-8601 date-time. Null when no filing has been recorded.

    • overdue
      Type: boolean

      Whether this filing is currently past its due date. Null when the overdue state cannot be determined.

  • 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

    • audited
      Type: boolean

      Whether the accounts for this period were audited. Null when not known for the period.

    • effectiveDate
      Type: string Format: date-time

      When this status took effect, as an ISO-8601 date-time. Null when unknown.

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

      Structured drivers for this status. Null when none are recorded.

      A structured factor contributing to a section's assessment

    • status
      Type: string enum

      Filing-health status at this point in time. Same vocabulary as the current filings.status. 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.
      values
      • CONSISTENT
      • INCONSISTENT
      • UNABLE_TO_ASSESS
  • 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

    • code
      Type: string | null

      Stable, machine-readable reason code for programmatic branching. RESERVED and currently always null — the canonical code vocabulary is being defined separately. The example shows the intended format; until it ships, rely on message.

    • message
      Type: string

      Human-readable, self-contained explanation of the factor (a full sentence).

  • 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

Grand Public API