> For the complete documentation index, see [llms.txt](https://api-docs.espysys.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-docs.espysys.com/company-search/search-response-schema.md).

# Search Response Schema

```json
{
  "$schema": "http://json-schema.org/schema#",
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "query": {
      "type": "object",
      "properties": {
        "company_name": {
          "type": [
            "string",
            "null"
          ]
        },
        "company_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "website": {
          "type": [
            "string",
            "null"
          ]
        },
        "jurisdiction": {
          "type": [
            "string",
            "null"
          ]
        },
        "language": {
          "type": "string"
        }
      }
    },
    "generated_at": {
      "type": "string"
    },
    "report": {
      "type": "object",
      "properties": {
        "identity": {
          "type": "object",
          "properties": {
            "resolved_name": {
              "type": "string"
            },
            "legal_name": {
              "type": "string"
            },
            "aliases": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "entity_type": {
              "type": "string"
            },
            "status": {
              "type": "string"
            },
            "jurisdiction": {
              "type": "string"
            },
            "registration_numbers": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string"
                  },
                  "value": {
                    "type": "string"
                  },
                  "country": {
                    "type": "string"
                  }
                }
              }
            },
            "founded_date": {
              "type": [
                "string",
                "null"
              ]
            },
            "dissolved_date": {
              "type": [
                "string",
                "null"
              ]
            },
            "website": {
              "type": [
                "string",
                "null"
              ]
            },
            "addresses": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "address": {
                    "type": "string"
                  },
                  "type": {
                    "type": "string"
                  },
                  "country": {
                    "type": "string"
                  }
                }
              }
            },
            "confidence": {
              "type": "string"
            },
            "ambiguity_notes": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "executive_summary": {
          "type": "string"
        },
        "business": {
          "type": "object",
          "properties": {
            "description": {
              "type": "string"
            },
            "industries": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "products_and_services": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "markets": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "parent_entities": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "subsidiaries": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "ownership": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "owner_type": {
                "type": "string"
              },
              "ownership_percent": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "relationship": {
                "type": "string"
              },
              "status": {
                "type": "string"
              }
            }
          }
        },
        "leadership": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "role": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "start_date": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "end_date": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        },
        "legal_proceedings": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string"
              },
              "court": {
                "type": "string"
              },
              "jurisdiction": {
                "type": "string"
              },
              "case_number": {
                "type": "string"
              },
              "parties": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "filed_date": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "status": {
                "type": "string"
              },
              "allegations": {
                "type": "string"
              },
              "outcome": {
                "type": "string"
              }
            }
          }
        },
        "regulatory_actions": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "sanctions": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "financial_signals": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string"
              },
              "date": {
                "type": "string"
              },
              "jurisdiction": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "details": {
                "type": "string"
              }
            }
          }
        },
        "adverse_media": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string"
              },
              "date": {
                "type": "string"
              },
              "jurisdiction": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "details": {
                "type": "string"
              }
            }
          }
        },
        "risk_assessment": {
          "type": "object",
          "properties": {
            "level": {
              "type": "string"
            },
            "summary": {
              "type": "string"
            },
            "risk_factors": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "coverage": {
          "type": "object",
          "properties": {
            "jurisdictions_searched": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "languages_searched": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "limitations": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "unverified_claims": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        }
      }
    }
  }
}
```