SearchResultDto

A single company that matched the search query.

  • address
    Type: string

    The company's registered address as a single preformatted line. May be null if no address is on file. See addressStructured for the same address broken into components.

  • addressStructured
    Type: object

    The company's registered address broken into individual components. May be null if no structured address is available.

    • city
      Type: string

      City or town. May be null.

    • country
      Type: string

      Country of the address. May be a country name or code as recorded by the source registry; not guaranteed to be a normalised ISO code. May be null.

    • latitude
      Type: number Format: double

      Latitude of the address in decimal degrees, obtained by geocoding. May be null if the address could not be geocoded.

    • longitude
      Type: number Format: double

      Longitude of the address in decimal degrees, obtained by geocoding. May be null if the address could not be geocoded.

    • postcode
      Type: string

      Postal or ZIP code. May be null.

    • region
      Type: string

      Region, county, state, or province. May be null.

    • streetLine1
      Type: string

      First line of the street address (e.g. building number and street). May be null.

    • streetLine2
      Type: string

      Second line of the street address (e.g. suite, floor, or locality). May be null.

  • avatar
    Type: object

    Display avatar for the company: a logo image URL when available, plus initials derived from the name for use as a fallback. May be null.

    • image
      Type: string

      Absolute URL of the company's logo image. null when no valid logo URL is available; clients should fall back to initials in that case.

    • initials
      Type: string

      A single uppercase initial derived from the first character of the company name, for use as a placeholder when no logo image is available. Empty string if the name is blank.

  • companyNumber
    Type: string

    The company's registration number as issued by the registry for its jurisdiction (for GB, the Companies House number). Format varies by jurisdiction. Combine with jurisdiction to uniquely identify a company.

  • incorporatedDate
    Type: string Format: date-time

    The date and time the company was incorporated / first registered, as an ISO-8601 timestamp with offset. May be null if unknown.

  • isGrandMember
    Type: boolean

    true if the company has a claimed or linked profile on the Grand network; false otherwise.

  • jurisdiction
    Type: string

    ISO 3166-1 alpha-2 code of the jurisdiction whose registry the company is registered in. This echoes the jurisdiction the search was run against (requests may supply either an alpha-2 or alpha-3 code, but the response always returns alpha-2).

  • name
    Type: string

    The company's registered legal name as held by the source company registry.

  • previousNames
    Type: array object[] · PreviousName[]

    The company's former registered names, ordered most-recent-first. May be null or empty if the company has never changed name or no history is available.

    A name the company was formerly registered under.

    • endDate
      Type: string Format: date

      The date this former name was superseded by the next name, as an ISO-8601 date (YYYY-MM-DD). May be null if unknown.

    • name
      Type: string

      The former registered legal name of the company.

    • startDate
      Type: string Format: date

      The date this former name took effect, as an ISO-8601 date (YYYY-MM-DD). May be null if unknown.

  • status
    Type: string enum

    Grand's machine-readable trading status for the company, derived from registry filings and signals. Values are precedence-ordered — terminal and insolvency states take priority over active/inactive. May be null when no status has been determined. 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

Grand Public API