Skip to main content

Table of Contents

Data Sources

Washington DC entity data comes from two complementary sources maintained by the DC Department of Licensing and Consumer Protection (DLCP), Business and Professional Licensing Administration (BPLA):
  • DC DLCP Open Data CSV (fast / onboarding mode): A daily open-data export published at opendata.dc.gov under CC BY 4.0. Covers all ~494k domestic and foreign registered entities, refreshed every day. Entity-level fields only — no principals roster.
  • DC BOSS register API (authoritative / verification mode): The register’s own live API behind the DLCP Business and Occupational Service System at boss.dc.gov. Returns the authoritative entity status, the full roster as filed (governors, directors, organizers, incorporators and beneficial owners), the registered agent, and the entity page captured as the Trade Register Extract.
In onboarding mode, data is served from the DC DLCP daily open-data snapshot. It is typically up to 24 hours behind the live register. The roster of people is not included in onboarding mode — it is only returned in verification mode, which reads the live register.
BOSS replaced the CorpOnline portal in August 2026. The two lanes do not share an identical status vocabulary — see Company Status.

Company Identifiers

Query Identifiers

DC File Number formats:
In the US-DC- form, the two letters match the entity type in the records we have seen: LL domestic LLC, CO domestic corporation, NP domestic nonprofit, LP domestic limited partnership, ST domestic statutory trust, GC and LC cooperative associations, and FN any foreign entity. In the older lettered forms the letter does not reliably give the entity type: many foreign LLCs carry a C number.Pass the file number exactly as a search result returns it, including leading zeros and the US-DC- prefix where present. A handful of old records carry irregular values such as 951448-4164482.

Identifiers in API Response

Search Capabilities

Search runs against the DC DLCP daily open-data extract. Name search uses any-word matching. File number lookup returns the exact match first with matchReason.matchType = "id"; other results may follow.

Active companies only

Search can return companies that are no longer active. Each result carries the register’s status, so activeOnly=true removes the inactive ones.

Quirks & Gotchas

Mappings

Company Status

Status is drawn directly from the DC DLCP register and mapped deterministically. No AI inference is involved. The open-data extract (onboarding mode) uses exactly the 12 values below. The live register (verification mode) can additionally return Expired and Active Trade Name, so an integration should treat the list as open rather than exhaustive. DC DLCP uses a closed list of 18 entity types. All 18 are derived from the exhaustive distinct set in the full DC DLCP open-data extract. Every entity in the register falls into exactly one of these types. In onboarding mode, legalForm carries the register’s entity-type label in localName only. The standardized category and the ISO 20275 code below are added in verification mode.
ISO 20275 ELF codes are assigned by jurisdiction of formation. Foreign variants (e.g. “Foreign Limited Liability Company”) are entities formed outside DC and qualified to do business in the District — they carry no DC ISO 20275 code because the code belongs to their formation jurisdiction.
Legal representatives are returned from the live register in verification mode only. The open-data extract does not include a roster. Role titles are standardized using AI enrichment — the raw title from the register is always preserved as role.localName, and a standardized category is added where one can be inferred. The register records two things per person: a governance title (Governor, Director, Organizer, Incorporator) and a separate capacity, most often Beneficial Owner. Topograph splits the roster on that distinction:
A person recorded solely as a beneficial owner is not a legal representative and is not returned as one. For entity types where DC records no governance title at all — commonly LLCs — legalRepresentatives can legitimately come back empty while the beneficial-owner roster is populated on otherKeyPersons. Read both if you need everyone on file.
legalRepresentatives is not available in onboarding (fast) mode: requesting it returns a failed datapoint with error code fast_source_unavailable. Individual vs. entity type is preserved on each record.

Other Key Persons

The registered agent is returned as an Other Key Person in both onboarding and verification modes. The role is returned as role.localName: "Registered Agent" with no standardized value. In onboarding mode, the agent is returned as an individual with the name and address from the open-data extract. In verification mode, the address is returned for individual agents only.

Statutory Filings

Washington DC entities file a biennial report confirming the entity’s particulars are current. The register publishes the date the next report is due and the date the last one was filed, returned on the cross-country statutoryFilings field as next.dueDate and lastFiled.filedOn.
US states publish no statutory accounts, so the accounts obligation is absent rather than returned empty. An empty object would read as “we looked and found nothing”, which is a different claim. Placeholder cells such as N/A or Inactive, Not Applicable are dropped rather than parsed as dates, so an entity with no obligation simply has no statutoryFilings.

Data Availability

Documents

Available Documents

The Trade Register Extract is included with the company data block at no extra charge. It is captured from the register’s live entity page and carries the register’s own banner, the source URL and the capture timestamp. It covers entity information, the biennial report status, the registered agent, the beneficial-owner roster, and any trade name and licence records.

Example API Responses

Every response below was captured from the live register, unedited apart from dropping internal ids. Query with POST /v2/company.

Search by Name

Search by DC File Number

Company Profile

Governors are filed with a governance title, so they are legal representatives. The registered agent is an Other Key Person.
The open-data snapshot carries entity-level fields and the registered agent only. No roster, and no activity description.