ProfileResponse

Full company profile

  • ai
    Type: object

    AI-generated narrative summary

    • summary
      Type: string

      Plain-text business summary

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

    Beneficial owners / persons with significant control

    A beneficial owner / person with significant control

    • isOrganization
      Type: boolean

      Whether the owner is an organization

    • linkedProfileId
      Type: string

      Grand network profile id of the owner, if known

    • name
      Type: string

      Owner name

    • nationality
      Type: string

      Nationality

    • ownership
      Type: string

      Ownership band

    • ownershipType
      Type: string

      Type of ownership

    • registrationNumber
      Type: string

      Registration number, if the owner is an organization

    • relationship
      Type: string

      Nature of control

    • residence
      Type: string

      Country of residence

    • startDate
      Type: stringFormat: date-time

      Date control commenced

  • businessDetails
    Type: object

    Company identity and registration details

    • companyType
      Type: string

      Legal form code

    • employees
      Type: integerFormat: int32

      Reported employee count

    • incorporationDate
      Type: stringFormat: date-time

      Date of incorporation

    • jurisdiction
      Type: string

      ISO 3166-1 alpha-2 jurisdiction code

    • legalName
      Type: string

      Registered legal name

    • previousNames
      Type: array string[]

      Former registered names

    • primarySicCode
      Type: string

      Primary SIC activity code

    • primarySicDescription
      Type: string

      Primary SIC activity description

    • registeredAddress
      Type: object · Address

      Registered office address

    • registrationNumber
      Type: string

      Company registration number

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

      SIC industry classification codes

      SIC industry classification code

  • compliance
    Type: object

    AML compliance: PEP, sanctions/watchlists and adverse media

    • directorsAndPscs
      Type: object · ComplianceSection

      Screening of directors and PSCs

    • entity
      Type: object · ComplianceSection

      Screening of the company itself

  • corporateStructure
    Type: object

    Corporate group structure

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

      Flat list of all group companies

      A company within the corporate group

    • immediateParent
      Type: object · StructureNode

      Immediate parent company

    • ownershipStatus
      Type: string

      Ownership status

    • ultimateParent
      Type: object · StructureNode

      Ultimate parent (group head)

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

    Court cases / litigation (from Caseboard)

    A court case against or involving the company

    • active
      Type: boolean

      Whether the case is still active

    • caseNumber
      Type: string

      Court case reference

    • category
      Type: string

      Case category

    • court
      Type: string

      Court name

    • dateFiled
      Type: stringFormat: date-time

      Date filed at court

    • status
      Type: string

      Case status

    • title
      Type: string

      Case title / party

    • type
      Type: string

      Notice type

    • url
      Type: string

      Link to the case, if available

  • creditCapacity
    Type: object

    How much monthly trade credit the company can support, based on its financial data.

    • effectiveDate
      Type: stringFormat: date-time

      When the current assessment took effect

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

      Prior credit-capacity assessments over time

      A point in the credit-capacity history

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

      Structured drivers behind the current capacity

      A structured factor contributing to a section's assessment

    • recommended
      Type: object · CreditLimit

      Recommended credit limit (monthly and yearly)

    • status
      Type: object · CreditCapacityStatusenum

      AVAILABLE — a credit limit is recommended; NOT_RECOMMENDED — credit is not recommended (limits are zero); SUSPENDED — assessment suspended, e.g. the company is not actively trading or an insolvency event was recorded (limits are zero).

      values
      • AVAILABLE

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

      • NOT_RECOMMENDED

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

      • SUSPENDED

        Assessment suspended (e.g. not actively trading or an insolvency event) --- limits are zero.

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

    Directors and secretaries (current and previous)

    A director or company secretary

    • active
      Type: boolean

      Whether the appointment is current

    • address
      Type: string

      Service / correspondence address

    • appointedDate
      Type: stringFormat: date-time

      Date appointed

    • birthMonth
      Type: integerFormat: int32

      Month of birth (1-12)

    • birthYear
      Type: integerFormat: int32

      Year of birth

    • name
      Type: string

      Full name

    • nationality
      Type: string

      Nationality

    • occupation
      Type: string

      Occupation

    • residence
      Type: string

      Country of residence

    • resignedDate
      Type: stringFormat: date-time

      Date resigned, if applicable

    • role
      Type: string

      Role

  • earlySignals
    Type: array object[] · EarlySignal[]

    Active forward-looking early-warning signals

    A forward-looking early-warning signal

    • details
      Type: string

      Fuller description and implications

    • eventDate
      Type: stringFormat: date-time

      When the underlying event occurred

    • evidenceLink
      Type: string

      Link to the underlying evidence

    • expiryDate
      Type: stringFormat: date-time

      When the signal expires

    • explanation
      Type: string

      One-line summary of the signal

    • firstSeenDate
      Type: stringFormat: date-time

      When Grand first detected the signal

    • retirementReason
      Type: string

      Why the signal was retired, if applicable

    • source
      Type: string

      Originating data source

    • type
      Type: string

      Signal type

  • earlySignalsHistory
    Type: array object[] · EarlySignal[]

    Retired / expired / superseded early-warning signals

    A forward-looking early-warning signal

    • details
      Type: string

      Fuller description and implications

    • eventDate
      Type: stringFormat: date-time

      When the underlying event occurred

    • evidenceLink
      Type: string

      Link to the underlying evidence

    • expiryDate
      Type: stringFormat: date-time

      When the signal expires

    • explanation
      Type: string

      One-line summary of the signal

    • firstSeenDate
      Type: stringFormat: date-time

      When Grand first detected the signal

    • retirementReason
      Type: string

      Why the signal was retired, if applicable

    • source
      Type: string

      Originating data source

    • type
      Type: string

      Signal type

  • eventHistory
    Type: array object[] · EventHistoryItem[]

    Chronological filing / notice history (Companies House and others)

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

    • date
      Type: stringFormat: date-time

      Event date

    • description
      Type: string

      Human-readable description

    • source
      Type: string

      Originating data source

    • type
      Type: string

      Event type

    • url
      Type: string

      Link to the underlying record, if any

  • filingBehaviour
    Type: object

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

    • accounts
      Type: object · AccountsFiling

      Annual accounts: filing status, type and audit characteristics

    • confirmationStatement
      Type: object · FilingDue

      Confirmation statement filing status

    • effectiveDate
      Type: stringFormat: date-time

      When the current status took effect

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

      Prior filing-behaviour values over time

      A point in the filing-behaviour history

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

      Structured drivers behind the current assessment

      A structured factor contributing to a section's assessment

    • status
      Type: stringenum

      Filing-health status code

      values
      • CONSISTENT
      • INCONSISTENT
      • UNABLE_TO_ASSESS
  • financials
    Type: object

    Filed financial accounts, most recent first

    • accountingReferenceDate
      Type: string

      Accounting reference date

    • currency
      Type: string

      Reporting currency

    • mostRecentAccountsDate
      Type: stringFormat: date-time

      Date of the most recent accounts

    • mostRecentFilingType
      Type: string

      Most recent filing type

    • nextAccountsDue
      Type: stringFormat: date-time

      When the next accounts are due

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

      Per-period accounts, most recent first

      Accounts for one accounting period

  • legalNotices
    Type: object

    Court judgments, Gazette notices and registered charges

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

      Registered charges / mortgages (empty until sourced on the profile)

      A registered charge / mortgage against the company

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

      UK Gazette notices

      A UK Gazette notice

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

      Court judgments (e.g. CCJs)

      A court judgment against the company

  • overview
    Type: object

    Company composition — size, complexity and maturity — in relation to its declared business activity.

    • complexity
      Type: string

      Corporate-structure complexity

    • maturity
      Type: string

      Maturity stage

    • size
      Type: string

      Size classification

    • yearsInBusiness
      Type: integerFormat: int32

      Years since incorporation

  • pendingSections
    Type: array string[]

    Sections still being computed and not yet present in this response. Retry shortly.

  • riskOfFailure
    Type: object

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

    • effectiveDate
      Type: stringFormat: date-time

      When the current assessment took effect

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

      Prior risk-of-failure assessments over time

      A point in the risk-of-failure history

    • level
      Type: stringenum

      Risk band, derived from probabilityOfDefault: LOW (<0.05), LOW_MEDIUM (0.05–0.10), MEDIUM (0.10–0.15), MEDIUM_HIGH (0.15–0.25), HIGH (≥0.25), or UNASSESSED.

      values
      • LOW
      • LOW_MEDIUM
      • MEDIUM
      • MEDIUM_HIGH
      • HIGH
      • UNASSESSED
    • probabilityOfDefault
      Type: numberFormat: double
      min:  
      0
      max:  
      1

      Estimated probability of failure as a decimal between 0.0 and 1.0 (0–100%).

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

      Structured drivers behind the current assessment

      A structured factor contributing to a section's assessment

  • tradingStatus
    Type: object

    Current legal status and whether the company is actively operating, inactive, or in a formal insolvency or closure process.

    • effectiveDate
      Type: stringFormat: date-time

      When the current status took effect

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

      Prior trading-status values over time

      A point in the trading-status history

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

      Structured drivers behind the current status

      A structured factor contributing to a section's assessment

    • status
      Type: stringenum

      Trading status code

      values
      • ACTIVELY_TRADING
      • INACTIVE
      • STRIKE_OFF_INITIATED
      • IN_LIQUIDATION
      • IN_ADMINISTRATION

Grand Public API