RiskOfFailure

Likelihood of financial distress or business failure within the next 12 months.

  • 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

    • date
      Type: string Format: date-time

      Timestamp (ISO-8601) at which this historical assessment was made.

    • level
      Type: string enum

      Risk band recorded at this point in time, using the same thresholds and vocabulary as the current riskOfFailure.level. 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 at that time.
      values
      • LOW
      • LOW_MEDIUM
      • MEDIUM
      • MEDIUM_HIGH
      • HIGH
      • UNABLE_TO_ASSESS
    • reasons
      Type: array object[] · StructuredReason[]

      Human-readable drivers recorded for this historical assessment.

      A structured factor contributing to a section's assessment

  • 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

    • 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).

Grand Public API