SearchResponse

A page of company search results.

  • results
    Type: array object[] · SearchResultDto[]

    The companies matching the query for this page, ordered by search relevance. Empty if there are no matches. The number of entries is bounded by the request's pageSize.

    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.

    • 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
  • total
    Type: integer Format: int32

    The total number of companies matching the query across all pages, as reported by the source registry. 0 when there are no matches.

Grand Public API