API
Every record on this site, as JSON.
Every business record is available as JSON, free and without a key. It is the same API that this site’s own pages are built on, and it is read-only. The data is refreshed weekly from the Virginia State Corporation Commission.
Endpoints
| Endpoint | Returns |
|---|---|
/api/search/{name} |
Up to 200 businesses whose name contains the search term, across every type of entity, each with its ID, name, status and incorporation date. The options below filter and order them. Example |
/api/business/{id} |
One business in full: its address, status, type of entity and industry, its registered agent, its officers, and the other businesses registered at the same address. Example |
/api/recent |
The 100 most recently registered businesses. Example |
Search options
These go in the query string, after the search term.
| Option | Values | Default |
|---|---|---|
status |
ACTIVE, INACTIVE or
PENDINACT. Any other value is ignored. |
Any status |
sort |
name or date
(of incorporation) |
name |
order |
asc or desc |
asc for names, desc
(newest first) for dates |
Examples
Active businesses with “peabody” in their name, newest first. Spaces
in a search term are written as %20.
curl "https://vabusiness.corphish.duckdns.org/api/search/peabody?status=ACTIVE&sort=date"One business, by the ID shown on its page:
curl "https://vabusiness.corphish.duckdns.org/api/business/F0000325"An ID that does not exist answers with a 404.
Everything at once
To work with all of the records rather than a few at a time, the bulk files this site is built from, and the whole database, are on the data page.