Table of Contents
- Data Sources
- Company Identifiers
- Search Capabilities
- Quirks & Gotchas
- Mappings
- Statutory Filings
- Data Availability
- Documents
- Example API Responses
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:
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, soactiveOnly=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 returnExpired and Active Trade Name, so an integration should treat the list as open rather than exhaustive.
Legal Forms
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.
Limited Liability Companies
Limited Liability Companies
Business Corporations
Business Corporations
Nonprofit Corporations
Nonprofit Corporations
Partnerships
Partnerships
Cooperative Associations — DC Code § 29-9
Cooperative Associations — DC Code § 29-9
Statutory Trusts — DC Code § 29-12
Statutory Trusts — DC Code § 29-12
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
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 asrole.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:
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 asrole.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-countrystatutoryFilings 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 withPOST /v2/company.
Search by Name
Search by DC File Number
Company Profile
Domestic Business Corporation (verification mode)
Domestic Business Corporation (verification mode)
Governors are filed with a governance title, so they are legal representatives. The registered agent is an Other Key Person.
Domestic LLC (verification mode) — beneficial owners, no legal representatives
Domestic LLC (verification mode) — beneficial owners, no legal representatives
DC records this LLC’s people as beneficial owners with no governance title, so
legalRepresentatives is empty and the roster is on otherKeyPersons. This is normal for DC LLCs — read both fields.Same corporation in onboarding mode (fast)
Same corporation in onboarding mode (fast)
The open-data snapshot carries entity-level fields and the registered agent only. No roster, and no activity description.
Foreign LLC qualified in DC (verification mode)
Foreign LLC qualified in DC (verification mode)
Dissolved entity (verification mode)
Dissolved entity (verification mode)
Available Documents
Available Documents