> ## Documentation Index > Fetch the complete documentation index at: https://docs.govfiles.dev/llms.txt > Use this file to discover all available pages before exploring further. # Company schema > The data we provide on each company The GovFiles dataset contains a single normalized company entity object per registration. This object is sourced directly from US state business registries. Raw registry strings are preserved in `*_raw` fields, and GovFiles adds normalized enum classifications alongside them (`status`, `legal_form`, party role kinds). Fields the registry does not publish are returned as `null`. Dates are ISO 8601 (`YYYY-MM-DD`). [View an example entity](#example-entity) ## Company entity | Field | Type | Required | Description | | ------------------- | ---------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------- | | `kind` | string | yes | Always `"company"`. | | `jurisdiction_code` | string | yes | Lowercase ISO 3166-2 style with underscore: `us_de`, `us_ca`, `us_ny`, etc. See [jurisdictions](/guides/jurisdictions). | | `entity_number` | string | yes | Unique ID assigned by the state registry (filing number, entity ID, etc). Stable across amendments. | | `legal_name` | string | yes | Legal name as currently registered. | | `status` | [Status](#status) | yes | Normalized registry status, classified by GovFiles. `"unknown"` when the registry publishes no status or we could not classify it. | | `status_raw` | string \| null | | Verbatim status string from the registry. Examples: `"Active"`, `"Good Standing"`, `"Revoked"`. Varies by state. | | `legal_form` | [LegalForm](#legalform) | yes | Normalized entity type, classified by GovFiles. | | `legal_form_raw` | string \| null | | Verbatim entity-type string from the registry. Examples: `"LLC"`, `"Domestic Profit Corporation"`. | | `domicile` | [Domicile](#domicile) | yes | `"domestic"` for home-state registrations, `"foreign"` for out-of-state qualifications. | | `formed_on` | date \| null | | Formation / registration date. | | `dissolved_on` | date \| null | | Dissolution date, if any. | | `addresses` | [Addresses](#addresses) \| null | | Registered, headquarters, and mailing addresses. | | `names` | [Name](#name)\[] \| null | | Non-current names: former legal names, DBAs, trade names, aliases. | | `parties` | [Party](#party)\[] \| null | | Every person or entity the registry associates with the company: officers, directors, members, registered agents, shareholders. | | `filings` | [Filing](#filing)\[] \| null | | Statutory filings: annual reports, amendments, certificates, etc. | | `relationships` | [Relationship](#relationship)\[] \| null | | Links to other registrations: merger survivors, home-state entities. | | `contact` | object \| null | | `websites` (string\[]), `phone`, `fax`. | | `industry_codes` | [IndustryCode](#industrycode)\[] \| null | | NAICS, SIC, NACE, etc. Scheme identified by `scheme`. | | `identifiers` | [Identifier](#identifier)\[] \| null | | External IDs: EIN, SEC CIK, LEI, etc. | | `entity_url` | string \| null | | Direct link to this entity on the state's registry website. | | `search_url` | string | yes | The state registry search page this record can be found through. | | `as_of` | date | yes | Date this snapshot was retrieved from the registry. | ## Nested objects ### Addresses Up to three addresses, each an [Address](#address) or `null`. | Field | Description | | -------------- | ----------------------------------------------------------------------------------- | | `registered` | Principal / registered office. | | `headquarters` | Where the business is actually operated, when distinct from the registered address. | | `mailing` | Correspondence address, when provided. | ### Address A postal address. When the registry publishes an unparseable string, it is preserved in `raw` and the structured fields are `null`. | Field | Type | Description | | ---------------- | -------------- | ---------------------------------------------------------------- | | `raw` | string \| null | Unparsed address string, when structured fields are unavailable. | | `street_address` | string \| null | | | `locality` | string \| null | City or town. | | `region` | string \| null | State, province, or equivalent. | | `postal_code` | string \| null | | | `country` | string \| null | Full country name. | | `country_code` | string \| null | ISO 3166-1 alpha-2. | ### Name A non-current name. The entity's current legal name lives in `legal_name`. | Field | Type | Description | | ------------ | --------------------- | ----------------------------------------- | | `name` | string | Required. | | `kind` | [NameKind](#namekind) | Required. | | `started_on` | date \| null | Date the company started using this name. | | `ended_on` | date \| null | Date the company stopped using this name. | ### Party A person or entity the registry associates with the company. One party can hold several roles — an officer who is also a shareholder appears once with two entries in `roles`. | Field | Type | Description | | --------- | --------------------------- | ---------------------------------------- | | `type` | [EntityKind](#entitykind) | `"person"`, `"company"`, or `"unknown"`. | | `name` | string | Required. | | `roles` | [Role](#role)\[] | The party's roles at this company. | | `address` | [Address](#address) \| null | | ### Role | Field | Type | Description | | ---------------------- | --------------------- | ------------------------------------------------------------------------------------------------- | | `kind` | [RoleKind](#rolekind) | Normalized role classification, by GovFiles. | | `title` | string \| null | Verbatim title from the registry. `"Director, President"`, `"Registered Agent"`, `"Member"`, etc. | | `ownership_percentage` | float \| null | 0–100. Set on shareholder roles when the registry discloses it. | | `started_on` | date \| null | When the party took the role. | | `ended_on` | date \| null | When they left the role. | ### Filing A statutory filing — annual report, amendment, certificate, dissolution, etc. | Field | Type | Description | | ------------- | -------------- | -------------------------------------------------------------------------- | | `id` | string \| null | Filing number or document ID from the registry. | | `title` | string \| null | | | `filed_on` | date | Required. Filing date. | | `type` | object \| null | `code` (registry's internal code) and `name` (human-readable filing type). | | `url` | string \| null | URL to the filing document on the state's site (PDF, image, etc.). | | `description` | string \| null | | ### Relationship A link from this registration to another one. | Field | Type | Description | | ---------------- | ------------------------------------- | --------------------------------------------------------------------------------------- | | `kind` | [RelationshipKind](#relationshipkind) | Required. | | `entity` | object | The related registration: `name`, `jurisdiction_code`, `entity_number` — each nullable. | | `effective_date` | date \| null | | ### IndustryCode | Field | Type | Description | | ------------- | -------------- | --------------------------------------------------------------------- | | `code` | string | Required. e.g. `"541512"`. | | `scheme` | string | Required. e.g. `"us_naics_2007"`, `"us_naics_2022"`, `"us_sic_1987"`. | | `description` | string \| null | Human-readable description of the code. | ### Identifier An external ID tied to the company. | Field | Type | Description | | -------- | ------ | --------------------------------------------------------------------------- | | `scheme` | string | Required. Scheme slug. Common values: `"us_fein"`, `"us_sec_cik"`, `"lei"`. | | `value` | string | Required. The identifier value. | ## Enums ### Status `active`, `inactive`, `dissolved`, `suspended`, `merged`, `withdrawn`, `unknown` ### LegalForm `llc`, `corporation`, `nonprofit`, `limited_partnership`, `limited_liability_partnership`, `partnership`, `trust`, `other`, `unknown` ### Domicile `domestic`, `foreign`, `unknown` ### EntityKind `person`, `company`, `unknown` ### RoleKind `registered_agent`, `officer`, `manager`, `member`, `governor`, `owner`, `incorporator`, `shareholder`, `other`, `unknown` ### NameKind | Value | Meaning | | ---------------- | -------------------------------------------------------------- | | `previous_legal` | Former legal name. | | `trading` | DBA / trade name. | | `alias` | Known-as name, abbreviation, or alternate-language legal name. | ### RelationshipKind | Value | Meaning | | ------------------------- | --------------------------------------------------------------- | | `merged_into` | This entity was merged into `entity`. | | `home_entity` | The home-state registration behind this foreign qualification. | | `subsequent_registration` | A later re-registration of this entity in another jurisdiction. | | `alternate_registration` | A parallel registration in another jurisdiction. | ## Example entity ```json theme={null} { "kind": "company", "jurisdiction_code": "us_fl", "entity_number": "612440", "legal_name": "N.P. EXPRESS OF FLORIDA, INC.", "status": "inactive", "status_raw": "Inactive", "legal_form": "corporation", "legal_form_raw": "Domestic Profit Corporation", "domicile": "domestic", "formed_on": "1979-03-12", "dissolved_on": null, "addresses": { "registered": { "raw": null, "street_address": "825 WEST LANDESBURY, P.O. BOX 2087", "locality": "SEBASTIAN", "region": "FL", "postal_code": "32958", "country": null, "country_code": null }, "headquarters": null, "mailing": { "raw": null, "street_address": "825 WEST LANDESBURY, P.O. BOX 2087", "locality": "SEBASTIAN", "region": "FL", "postal_code": "32958", "country": null, "country_code": null } }, "names": [ { "name": "NP EXPRESS", "kind": "trading", "started_on": null, "ended_on": null } ], "parties": [ { "type": "person", "name": "MAY, JENNIE", "roles": [ { "kind": "registered_agent", "title": "Registered Agent", "ownership_percentage": null, "started_on": null, "ended_on": null } ], "address": { "raw": "825 W LANDESBURY", "street_address": null, "locality": null, "region": null, "postal_code": null, "country": null, "country_code": null } }, { "type": "person", "name": "BAMBRICK, JOSEPH T JR", "roles": [ { "kind": "officer", "title": "Director, President", "ownership_percentage": null, "started_on": null, "ended_on": null }, { "kind": "shareholder", "title": "Shareholder", "ownership_percentage": 60.0, "started_on": null, "ended_on": null } ], "address": { "raw": null, "street_address": "217 OLD AIRPORT RD", "locality": "DOUGLASSVILLE", "region": "PA", "postal_code": null, "country": null, "country_code": null } }, { "type": "company", "name": "BAMBRICK HOLDINGS LLC", "roles": [ { "kind": "shareholder", "title": "Shareholder", "ownership_percentage": 40.0, "started_on": null, "ended_on": null } ], "address": null } ], "filings": [ { "id": "612440.00001", "title": null, "filed_on": "1988-11-04", "type": { "code": "CORAMINVOL", "name": "INVOLUNTARILY DISSOLVED" }, "url": null, "description": null } ], "relationships": [ { "kind": "merged_into", "entity": { "name": "N.P. EXPRESS HOLDINGS, INC.", "jurisdiction_code": "us_fl", "entity_number": "P98000012345" }, "effective_date": "1998-06-30" } ], "contact": { "websites": [ "https://npexpress.example" ], "phone": "772-555-0100", "fax": null }, "industry_codes": [ { "code": "484110", "scheme": "us_naics_2017", "description": "General Freight Trucking, Local" } ], "identifiers": [ { "scheme": "us_fein", "value": "591896165" } ], "entity_url": "https://search.sunbiz.org/Inquiry/CorporationSearch/SearchResultDetail?aggregateId=domp-612440", "search_url": "https://search.sunbiz.org/Inquiry/CorporationSearch/ByName", "as_of": "2026-05-27" } ```