Company schema

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

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.
`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	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	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	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 \| null		Registered, headquarters, and mailing addresses.
`names`	Name[] \| null		Non-current names: former legal names, DBAs, trade names, aliases.
`parties`	Party[] \| null		Every person or entity the registry associates with the company: officers, directors, members, registered agents, shareholders.
`filings`	Filing[] \| null		Statutory filings: annual reports, amendments, certificates, etc.
`relationships`	Relationship[] \| null		Links to other registrations: merger survivors, home-state entities.
`contact`	object \| null		`websites` (string[]), `phone`, `fax`.
`industry_codes`	IndustryCode[] \| null		NAICS, SIC, NACE, etc. Scheme identified by `scheme`.
`identifiers`	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 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	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	`"person"`, `"company"`, or `"unknown"`.
`name`	string	Required.
`roles`	Role[]	The party’s roles at this company.
`address`	Address \| null

Role

Field	Type	Description
`kind`	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	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

{
  "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"
}

Get started

Concepts

Endpoints

Bulk data

Company entity

Nested objects

Addresses

Address

Name

Party

Role

Filing

Relationship

IndustryCode

Identifier

Enums

Status

LegalForm

Domicile

EntityKind

RoleKind

NameKind

RelationshipKind

Example entity

​Company entity

​Nested objects

​Addresses

​Address

​Name

​Party

​Role

​Filing

​Relationship

​IndustryCode

​Identifier

​Enums

​Status

​LegalForm

​Domicile

​EntityKind

​RoleKind

​NameKind

​RelationshipKind

​Example entity

Company entity

Nested objects

Addresses

Address

Name

Party

Role

Filing

Relationship

IndustryCode

Identifier

Enums

Status

LegalForm

Domicile

EntityKind

RoleKind

NameKind

RelationshipKind

Example entity