{"slug":"api-scrapebench-dev-v1-va-contractor-licenses-6f1238","title":"Look up Virginia contractor and trade licences (DPOR) by business or person name","host":"api.scrapebench.dev","method":"POST","resource":"https://api.scrapebench.dev/v1/va-contractor-licenses","category":"other","description":"Look up Virginia contractor and trade licences (DPOR) by business or person name and city, returning licence number, class, address, expiry, specialties and email. Statewide roster, refreshed nightly from DPOR's official regulant lists.","price_listed":0.08,"price_asked":0.08,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":264,"reported_calls_30d":2,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"name":"engineering"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"city":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Case-insensitive substring of the licensee's city.","title":"City"},"license_types":{"description":"Which DPOR licence lists to search. Default: Class A, B and C contractors.","items":{"enum":["class_a","class_a_legacy","class_b","class_c","temporary","residential_tradesman","backflow_prevention","elevator_mechanic","water_well_provider","accessibility_mechanic","energy_analyst","energy_analyst_firm","sprinkler_inspector"],"type":"string"},"maxItems":13,"title":"License Types","type":"array"},"name":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Case-insensitive substring of the individual or business name.","title":"Name"}},"title":"Input","type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"properties":{"next_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Page to request next, or null when this is the last.","title":"Next Page"},"page":{"description":"Zero-based page number of this response.","title":"Page","type":"integer"},"page_size":{"description":"Most rows a page can hold; one page is one price.","title":"Page Size","type":"integer"},"rows":{"description":"Data rows, or free Notice rows explaining a gap.","items":{"anyOf":[{"additionalProperties":false,"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Mailing address, both lines joined by a comma.","title":"Address"},"business_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Licensed business name.","title":"Business Name"},"certification_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date first certified, MM/DD/YYYY.","title":"Certification Date"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Mailing-address city.","title":"City"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Country for non-US addresses, else null.","title":"Country"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Email address on file with DPOR, when published.","title":"Email"},"expiration_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Licence expiry, MM/DD/YYYY as DPOR writes it.","title":"Expiration Date"},"individual_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Licensee's name when licensed as an individual.","title":"Individual Name"},"license_number":{"description":"DPOR certificate (licence) number.","title":"License Number","type":"string"},"license_rank":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"DPOR licence rank code.","title":"License Rank"},"license_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Licence list the row came from, e.g. 'Class A Contractor'.","title":"License Type"},"scraped_at":{"description":"UTC timestamp of the read.","format":"date-time","title":"Scraped At","type":"string"},"source_url":{"description":"The URL or endpoint this record was read from.","title":"Source Url","type":"string"},"specialties":{"description":"DPOR specialty codes, e.g. ELE, PLB, HVA.","items":{"type":"string"},"title":"Specialties","type":"array"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Mailing-address state code.","title":"State"},"zip_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ZIP, with the +4 extension when DPOR has one.","title":"Zip Code"}},"required":["source_url","license_number"],"title":"Output","type":"object"},{"additionalProperties":false,"description":"A free row explaining why a page has no (or partial) data. Never charged.","properties":{"notice":{"description":"Human-readable reason, and what to send instead if the input was the problem.","title":"Notice","type":"string"},"notice_type":{"default":"input_error","description":"Machine-readable reason: input_error, no_results, blocked, truncated, source_changed, not_ready or stale.","title":"Notice Type","type":"string"},"scraped_at":{"description":"UTC timestamp of the read.","format":"date-time","title":"Scraped At","type":"string"},"source_url":{"default":"","description":"Empty: a notice is about the request, not about a page.","title":"Source Url","type":"string"}},"required":["notice"],"title":"Notice","type":"object"}]},"title":"Rows","type":"array"},"service":{"description":"The service that answered.","title":"Service","type":"string"}},"required":["service","page","page_size","next_page","rows"],"title":"VaContractorLicensesPage","type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-18","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.08,"price_match":true,"latency_ms":264,"error":null}],"description_full":"Look up Virginia contractor and trade licences (DPOR) by business or person name and city, returning licence number, class, address, expiry, specialties and email. Statewide roster, refreshed nightly from DPOR's official regulant lists.","last_updated":"2026-10-16T04:01:05.058Z","schemes":["exact"]}