--- type: "firecrawl-provider" description: "Virginia State Corporation Commission Clerk's Information System public business entity search at cis.scc.virginia.gov: entity search by name or SCC entity id with entity type, status and jurisdiction filters; entity detail with status, formation and status dates, jurisdiction, industry code, registered agent, principal office, principals and shares; filing history with document ids; registered agent history and name history, all keyed by the site's internal numeric business_id. Server-rendered HTML behind a cookie-consent gate that the program clears itself; anonymous, no login. UCC, certificate verification, property-owner search and PDF images are not covered." use_when: "Virginia State Corporation Commission Clerk's Information System public business entity search at cis.scc.virginia.gov: entity search by name or SCC entity id with entity type, status and jurisdiction filters; entity detail with status, formation and status dates, jurisdiction, industry code, registered agent, principal office, principals and shares; filing history with document ids; registered agent history and name history, all keyed by the site's internal numeric business_id. Server-rendered HTML behind a cookie-consent gate that the program clears itself; anonymous, no login. UCC, certificate verification, property-owner search and PDF images are not covered." categories: "Public records" capabilities: 5 credits_per_call: 5 --- # Virginia SCC Clerk's Information System (business entity registry) on Firecrawl Alexandria Virginia State Corporation Commission Clerk's Information System public business entity search at cis.scc.virginia.gov: entity search by name or SCC entity id with entity type, status and jurisdiction filters; entity detail with status, formation and status dates, jurisdiction, industry code, registered agent, principal office, principals and shares; filing history with document ids; registered agent history and name history, all keyed by the site's internal numeric business_id. Server-rendered HTML behind a cookie-consent gate that the program clears itself; anonymous, no login. UCC, certificate verification, property-owner search and PDF images are not covered. - Categories: Public records - Category index: [Public records category](https://firecrawl.dev/alexandria/agents/categories/public-records) - Provider key: `cis-scc-virginia-gov` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/cis-scc-virginia-gov) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/cis-scc-virginia-gov/openapi.json) ## Capabilities - [Get entity](https://firecrawl.dev/alexandria/agents/providers/cis-scc-virginia-gov/entities/get_entity): Entity detail from the Virginia SCC registry (GET /EntitySearch/BusinessInformation) for the site's internal numeric business_id returned by search_entities: entity name, SCC entity id, entity type, status (with the site's reason for status), series-LLC flag, formation date, status date, VA qualification date, period of duration, industry code, annual report due date, jurisdiction, charter fee, registration fee due date; the registered agent block (type, locality, qualification, name, registered office address); principal office address; the principals table (title, director flag, name, address, last updated) and total shares for stock corporations. The site renders 'N/A' for fields that do not apply; those are null. An unknown business_id is not_found (the site answers an empty page). - [Get entity agent history](https://firecrawl.dev/alexandria/agents/providers/cis-scc-virginia-gov/entities/get_entity_agent_history): Registered agent (RA) history of one entity (POST /EntitySearch/BusinessAgentHistory) for the site's internal numeric business_id: appointed date, end date, RA name, registered office address, locality and RA qualification per row, with the entity header (SCC entity id and name). The current agent is on get_entity; this grid read 'No records to view.' for every entity observed so far (an LLC, two foreign corporations and a 1983 domestic corporation, including entities with a filed statement of change of registered agent), so an empty agents array is the common, valid answer and the row shape is modelled on the site's column headers. An unknown business_id is not_found. - [Get entity filings](https://firecrawl.dev/alexandria/agents/providers/cis-scc-virginia-gov/entities/get_entity_filings): Filing history of one entity (POST /EntitySearch/BusinessFilings) for the site's internal numeric business_id: received date, effective date, filing number, microfilm number, document type, status, amendment type, source, page count and, when the site links an image, the document id and the PDF URL (/CommonHelper/DocumentStorageLocalFileget, which needs the consent cookie; the PDF itself is not fetched). The page also carries the entity header, returned as entity_id and entity_name. Pages of 10 rows: page N > 1 is fetched with the grid pager on the same session (verified live to the last page). Page count is null where the site shows N/A (older filings). An unknown business_id is not_found. - [Get entity name history](https://firecrawl.dev/alexandria/agents/providers/cis-scc-virginia-gov/entities/get_entity_name_history): Name history of one entity (POST /EntitySearch/BusinessNameHistory) for the site's internal numeric business_id: effective start date, effective end date, name and name type (Legal Name, Former Name, Fictitious Name, ...) per row, with the entity header. An entity whose history grid reads 'No records to view.' is a valid empty result; an unknown business_id is not_found. - [Search entities](https://firecrawl.dev/alexandria/agents/providers/cis-scc-virginia-gov/entities/search_entities): Search the Virginia SCC business entity registry (POST /EntitySearch/Index) by entity name (Starts With, Contains or Exact Match) or by SCC entity id, optionally filtered by entity type, status and jurisdiction (Virginia or foreign). Returns the results grid as displayed: SCC entity_id, entity name, name type (Legal Name or Fictitious Name), entity type, series-LLC flag, principal office address, registered agent name, status, plus the site's internal numeric business_id that get_entity, get_entity_filings, get_entity_agent_history and get_entity_name_history take. 25 rows per page; the site's pager is session-bound, so page N re-runs the search and asks the pager for page N on the same session. A search with no match is a valid empty result (the site's 'No records found with your search criteria.'), not an error. One entity id can return many rows (one per legal and fictitious name). ## 1. Choose this provider when Virginia State Corporation Commission Clerk's Information System public business entity search at cis.scc.virginia.gov: entity search by name or SCC entity id with entity type, status and jurisdiction filters; entity detail with status, formation and status dates, jurisdiction, industry code, registered agent, principal office, principals and shares; filing history with document ids; registered agent history and name history, all keyed by the site's internal numeric business_id. Server-rendered HTML behind a cookie-consent gate that the program clears itself; anonymous, no login. UCC, certificate verification, property-owner search and PDF images are not covered. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "cis-scc-virginia-gov", "capability": "entities/get_entity", "options": { "business_id": "205321" } } ``` ## 3. Add provider options Use only the options needed for the task: - `business_id` (string, required): The site's internal numeric business id from search_entities (e.g. 820120, 205321, 228610), not the SCC entity id. Pattern: ^[0-9]+$. Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "cis-scc-virginia-gov", capability: "entities/get_entity", options: { business_id: "205321", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "cis-scc-virginia-gov", "capability": "entities/get_entity", "options": { "business_id": "205321" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "cis-scc-virginia-gov", "capability": "entities/get_entity", "options": { "business_id": "205321" } } }' ``` ### CLI ```sh firecrawl scrape 'cis-scc-virginia-gov/entities/get_entity' \ --options '{"business_id":"205321"}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "cis-scc-virginia-gov", "capability": "entities/get_entity", "options": { "business_id": "205321" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "cis-scc-virginia-gov", "capability": "entities/get_entity", "options": { "business_id": "205321" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "additional_details": {}, "annual_report_due_date": "2008-10-31", "business_id": "205321", "charter_fee": "$50.00", "entity_id": "F1725607", "entity_name": "Capital One Agency Corporation", "entity_type": "Stock Corporation", "formation_date": null, "industry_code": "35 - Insurance Agencies", "jurisdiction": "NY", "observed_at_ms": 1791012969993, "period_of_duration": "Perpetual", "principal_office_address": "265 BROADHOLLOW RD, MELVILLE, NY, 11747 - 0000, USA", "principals": [ { "address": "265 BROADHOLLOW RD, MELVILLE, NY, 11747 - 0000, USA", "director": false, "last_updated": "2007-12-21", "name": "MATTHEW MURPHY", "title": "President" }, { "address": "265 BROADHOLLOW RD, MELVILLE, NY, 11747 - 0000, USA", "director": false, "last_updated": "2007-12-21", "name": "WILLIAM T SPENCER", "title": "VP/DTR" } ], "registered_agent": { "locality": "RICHMOND CITY", "name": "CORPORATION SERVICE COMPANY", "qualification": "BUSINESS ENTITY THAT IS AUTHORIZED TO TRANSACT BUSINESS IN VIRGINIA", "ra_type": "Entity", "registered_office_address": "100 SHOCKOE SLIP, 2ND FLOOR, RICHMOND, VA, 23219 - 0000, USA" }, "registration_fee_due_date": "2008-10-31", "series_llc": null, "source_url": "https://cis.scc.virginia.gov/EntitySearch/BusinessInformation?businessId=205321&source=FromEntityResult&isSeries=false", "status": "Inactive", "status_date": "2008-08-07", "status_reason": "Merged", "total_shares": "200", "va_qualification_date": "2007-10-19" } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Get entity - Capability: `entities/get_entity` - Description: Entity detail from the Virginia SCC registry (GET /EntitySearch/BusinessInformation) for the site's internal numeric business_id returned by search_entities: entity name, SCC entity id, entity type, status (with the site's reason for status), series-LLC flag, formation date, status date, VA qualification date, period of duration, industry code, annual report due date, jurisdiction, charter fee, registration fee due date; the registered agent block (type, locality, qualification, name, registered office address); principal office address; the principals table (title, director flag, name, address, last updated) and total shares for stock corporations. The site renders 'N/A' for fields that do not apply; those are null. An unknown business_id is not_found (the site answers an empty page). - Instructions: After search_entities, to read the full record and current status of one entity. - Cost: 5 credits per call - Capability file: [Get entity](https://firecrawl.dev/alexandria/agents/providers/cis-scc-virginia-gov/entities/get_entity) Accepted options: - `business_id` (string, required): The site's internal numeric business id from search_entities (e.g. 820120, 205321, 228610), not the SCC entity id. Pattern: ^[0-9]+$. Example: `` Response schema example: ```json { "additional_details": {}, "annual_report_due_date": "2008-10-31", "business_id": "205321", "charter_fee": "$50.00", "entity_id": "F1725607", "entity_name": "Capital One Agency Corporation", "entity_type": "Stock Corporation", "formation_date": null, "industry_code": "35 - Insurance Agencies", "jurisdiction": "NY", "observed_at_ms": 1791012969993, "period_of_duration": "Perpetual", "principal_office_address": "265 BROADHOLLOW RD, MELVILLE, NY, 11747 - 0000, USA", "principals": [ { "address": "265 BROADHOLLOW RD, MELVILLE, NY, 11747 - 0000, USA", "director": false, "last_updated": "2007-12-21", "name": "MATTHEW MURPHY", "title": "President" }, { "address": "265 BROADHOLLOW RD, MELVILLE, NY, 11747 - 0000, USA", "director": false, "last_updated": "2007-12-21", "name": "WILLIAM T SPENCER", "title": "VP/DTR" } ], "registered_agent": { "locality": "RICHMOND CITY", "name": "CORPORATION SERVICE COMPANY", "qualification": "BUSINESS ENTITY THAT IS AUTHORIZED TO TRANSACT BUSINESS IN VIRGINIA", "ra_type": "Entity", "registered_office_address": "100 SHOCKOE SLIP, 2ND FLOOR, RICHMOND, VA, 23219 - 0000, USA" }, "registration_fee_due_date": "2008-10-31", "series_llc": null, "source_url": "https://cis.scc.virginia.gov/EntitySearch/BusinessInformation?businessId=205321&source=FromEntityResult&isSeries=false", "status": "Inactive", "status_date": "2008-08-07", "status_reason": "Merged", "total_shares": "200", "va_qualification_date": "2007-10-19" } ``` ### Get entity agent history - Capability: `entities/get_entity_agent_history` - Description: Registered agent (RA) history of one entity (POST /EntitySearch/BusinessAgentHistory) for the site's internal numeric business_id: appointed date, end date, RA name, registered office address, locality and RA qualification per row, with the entity header (SCC entity id and name). The current agent is on get_entity; this grid read 'No records to view.' for every entity observed so far (an LLC, two foreign corporations and a 1983 domestic corporation, including entities with a filed statement of change of registered agent), so an empty agents array is the common, valid answer and the row shape is modelled on the site's column headers. An unknown business_id is not_found. - Instructions: To see past and current registered agents of an entity. - Cost: 5 credits per call - Capability file: [Get entity agent history](https://firecrawl.dev/alexandria/agents/providers/cis-scc-virginia-gov/entities/get_entity_agent_history) Accepted options: - `business_id` (string, required): The site's internal numeric business id from search_entities. Pattern: ^[0-9]+$. Example: `` Response schema example: ```json { "agents": [], "business_id": "205321", "entity_id": "F1725607", "entity_name": "Capital One Agency Corporation", "observed_at_ms": 1791013002142, "source_url": "https://cis.scc.virginia.gov/EntitySearch/BusinessAgentHistory" } ``` ### Get entity filings - Capability: `entities/get_entity_filings` - Description: Filing history of one entity (POST /EntitySearch/BusinessFilings) for the site's internal numeric business_id: received date, effective date, filing number, microfilm number, document type, status, amendment type, source, page count and, when the site links an image, the document id and the PDF URL (/CommonHelper/DocumentStorageLocalFileget, which needs the consent cookie; the PDF itself is not fetched). The page also carries the entity header, returned as entity_id and entity_name. Pages of 10 rows: page N > 1 is fetched with the grid pager on the same session (verified live to the last page). Page count is null where the site shows N/A (older filings). An unknown business_id is not_found. - Instructions: To list an entity's filings and their document ids after search_entities or get_entity. - Cost: 5 credits per call - Capability file: [Get entity filings](https://firecrawl.dev/alexandria/agents/providers/cis-scc-virginia-gov/entities/get_entity_filings) Accepted options: - `business_id` (string, required): The site's internal numeric business id from search_entities. Pattern: ^[0-9]+$. Example: `` - `page` (number): 1-based page of the filing grid, 10 rows per page. Example: `1` Response schema example: ```json { "business_id": "820120", "entity_id": "T0608648", "entity_name": "Capital One Advisors, LLC", "filings": [ { "amendment_type": null, "document_id": "3181857", "document_type": "Statement of Change of Registered Office and/or Registered Agent", "document_url": "https://cis.scc.virginia.gov/CommonHelper/DocumentStorageLocalFileget?DocumentId=3181857&sourceType=1", "effective_date": "2018-01-01", "filing_number": "1712080601", "microfilm_number": "1801210002", "page_count": 871, "received_date": "2018-01-01", "source": "In-House", "status": "Approved" }, { "amendment_type": "Jurisdiction of Formation, Restatement", "document_id": "2725590", "document_type": "Amended Application for a Certificate of Registration", "document_url": "https://cis.scc.virginia.gov/CommonHelper/DocumentStorageLocalFileget?DocumentId=2725590&sourceType=1", "effective_date": "2017-02-27", "filing_number": "1702241224", "microfilm_number": "1702090090", "page_count": 11, "received_date": "2017-02-27", "source": "In-House", "status": "Approved" }, { "amendment_type": null, "document_id": "2078058", "document_type": "Application for a Certificate of Registration", "document_url": "https://cis.scc.virginia.gov/CommonHelper/DocumentStorageLocalFileget?DocumentId=2078058&sourceType=1", "effective_date": "2015-04-17", "filing_number": "1502131217", "microfilm_number": "1504060457", "page_count": 20, "received_date": "2015-04-17", "source": "In-House", "status": "Approved" } ], "observed_at_ms": 1791012981882, "page": 1, "source_url": "https://cis.scc.virginia.gov/EntitySearch/BusinessFilings", "total_pages": 1, "total_records": 3 } ``` ### Get entity name history - Capability: `entities/get_entity_name_history` - Description: Name history of one entity (POST /EntitySearch/BusinessNameHistory) for the site's internal numeric business_id: effective start date, effective end date, name and name type (Legal Name, Former Name, Fictitious Name, ...) per row, with the entity header. An entity whose history grid reads 'No records to view.' is a valid empty result; an unknown business_id is not_found. - Instructions: To see former and fictitious names of an entity. - Cost: 5 credits per call - Capability file: [Get entity name history](https://firecrawl.dev/alexandria/agents/providers/cis-scc-virginia-gov/entities/get_entity_name_history) Accepted options: - `business_id` (string, required): The site's internal numeric business id from search_entities. Pattern: ^[0-9]+$. Example: `` Response schema example: ```json { "business_id": "205321", "entity_id": "F1725607", "entity_name": "Capital One Agency Corporation", "names": [ { "effective_end_date": null, "effective_start_date": "2008-08-07", "name": "CAPITAL ONE AGENCY CORPORATION", "name_type": "Legal Name" }, { "effective_end_date": "2008-08-07", "effective_start_date": "2007-10-19", "name": "NFB AGENCY CORPORATION", "name_type": "Former Name" } ], "observed_at_ms": 1791013052592, "source_url": "https://cis.scc.virginia.gov/EntitySearch/BusinessNameHistory" } ``` ### Search entities - Capability: `entities/search_entities` - Description: Search the Virginia SCC business entity registry (POST /EntitySearch/Index) by entity name (Starts With, Contains or Exact Match) or by SCC entity id, optionally filtered by entity type, status and jurisdiction (Virginia or foreign). Returns the results grid as displayed: SCC entity_id, entity name, name type (Legal Name or Fictitious Name), entity type, series-LLC flag, principal office address, registered agent name, status, plus the site's internal numeric business_id that get_entity, get_entity_filings, get_entity_agent_history and get_entity_name_history take. 25 rows per page; the site's pager is session-bound, so page N re-runs the search and asks the pager for page N on the same session. A search with no match is a valid empty result (the site's 'No records found with your search criteria.'), not an error. One entity id can return many rows (one per legal and fictitious name). - Instructions: Start here to find an entity's business_id and SCC entity id; use get_entity for the full record. - Cost: 5 credits per call - Capability file: [Search entities](https://firecrawl.dev/alexandria/agents/providers/cis-scc-virginia-gov/entities/search_entities) Accepted options: - `entity_type` (string): Optional entity type filter (the site's Business Type select). Example: `llc` - `jurisdiction` (string): Optional jurisdiction filter: entities formed in Virginia or foreign entities registered to do business in Virginia. Example: `virginia` - `match` (string): The site's name search logic: Starts With (the site's default), Contains or Exact Match. Ignored for entity_id searches. Example: `starts_with` - `page` (number): 1-based results page, 25 rows per page. Example: `1` - `query` (string, required): Entity name text (search_type entity_name) or an SCC entity id such as T0608648, F1725607 or 11035161 (search_type entity_id). Example: `` - `search_type` (string): Which field the site searches: the entity name (SearchType=businessname) or the SCC entity id (SearchType=businessid). Example: `entity_name` - `status` (string): Optional status filter (the site's Business Status select). Example: `pending_active` Response schema example: ```json { "match": "exact", "observed_at_ms": 1791012960762, "page": 1, "query": "Capital One Financial Corporation", "results": [ { "business_id": "228610", "entity_id": "F1195066", "entity_name": "CAPITAL ONE FINANCIAL CORPORATION", "entity_type": "Stock Corporation", "name_type": "Legal Name", "principal_office_address": "1680 Capital One Dr, Mc Lean, VA, 22102 - 3407, USA", "registered_agent_name": "CORPORATION SERVICE COMPANY", "series_llc": null, "source_url": "https://cis.scc.virginia.gov/EntitySearch/BusinessInformation?businessId=228610&source=FromEntityResult&isSeries=false", "status": "Active" } ], "search_type": "entity_name", "source_url": "https://cis.scc.virginia.gov/EntitySearch/Index", "total_pages": 1, "total_records": 1 } ```