{"id":"b28d61e1-417f-4d2d-b3bf-d7291e374918","slug":"file-dos-pa-gov-api","name":"file.dos.pa.gov API","description":"file.dos.pa.gov API","front_facing_description":"Access data from file.dos.pa.gov.","source_url":"https://file.dos.pa.gov/search/business","is_authenticated":false,"canonical_scraper_id":"c4b6d613-109b-445f-a391-e1e7ddcb2cc7","apis":[{"method":"GET","endpoint_name":"search_entities","description":"Search the Pennsylvania Department of State business entity database by entity name or entity number. Supports 'starts with' and 'contains' matching. Returns all matching entities with their entity number, name, type, status, initial filing date, jurisdiction, and standing. The single upstream call returns all matches without pagination. Searching by entity number (numeric input) also works through the same name search field.","input_params":{"query":{"type":"string","required":true,"description":"Entity name or entity number to search for.","domain":{"kind":"open","example":"GOOGLE","generator":{"type":"static","value":"GOOGLE"}}},"search_type":{"type":"string","required":false,"description":"Match mode for the query. Omitting defaults to 'starts_with'.","default":"starts_with","enum":"SearchType","closed":true,"domain":{"kind":"enum","generator":{"type":"enum_pick","member":"STARTS_WITH"},"exhaustive":true}}},"return_schema":{"type":"object","fields":{"query":"The search query that was executed","entities":"Array of matching business entities","search_type":"The match mode used (starts_with or contains)","total_results":"Number of matching entities returned"},"sample":{"data":{"query":"GOOGLE","entities":[{"status":"Active","standing":"Not Good Standing","entity_name":"GOOGLE PAYMENT CORP.","entity_type":"Foreign Business Corporation","filing_date":"04/14/2005","former_name":null,"jurisdiction":"DELAWARE","entity_number":"0003299074"}],"search_type":"starts_with","total_results":12},"status":"success"}},"initiates_session":false,"price":2,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.entities","op":"array_min_len","value":1},{"path":"$.data.entities[*]","op":"field_present","value":"entity_number"},{"path":"$.data.entities[*]","op":"field_present","value":"entity_name"}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_entity_details","description":"Retrieve detailed information for a Pennsylvania business entity by its entity number. Returns entity details including registered office address, principal address, registered agent, officers/governors, formation date, jurisdiction, status, standing, business activity, and complete filing history. The entity_number must be the 10-digit zero-padded number (e.g. '0003299074') as returned by search_entities; if a shorter numeric string is supplied the scraper zero-pads it automatically. Makes two upstream requests: one for entity details and one for filing history.","input_params":{"entity_number":{"type":"string","required":true,"description":"10-digit zero-padded entity number from search_entities (e.g. '0003299074'). Shorter numeric strings are automatically zero-padded.","domain":{"kind":"derived","generator":{"path":"$.data.entities[*].entity_number","type":"derived","from_endpoint":"search_entities"}}}},"return_schema":{"type":"object","fields":{"status":"Current status (e.g. Active, Inactive - Withdrawn)","officers":"Array of officers/governors with name, title, and role","standing":"Good standing status","entity_name":"Official entity name","entity_type":"Type of entity (e.g. Foreign Business Corporation)","jurisdiction":"State or country of formation","entity_number":"10-digit zero-padded entity number","filing_history":"Array of filing history entries with type, date, status, and DLN","formation_date":"Date of initial filing in ISO format","registered_agent":"Name of the registered agent","term_of_duration":"Duration term (e.g. Perpetual)","business_activity":"Declared business activity","principal_address":"Principal business address","annual_report_due_date":"Next annual report due date","registered_office_address":"Physical address of the registered office in PA"},"sample":{"data":{"status":"Active","officers":[{"name":"Siddharth Mundra","role":"Governors","title":null,"is_organization":false}],"standing":"Good","entity_name":"GOOGLE PAYMENT CORP.","entity_type":"Foreign Business Corporation","jurisdiction":"DELAWARE","entity_number":"0003299074","filing_history":[{"dln":"A3046404-1","date":"2005-04-14T00:00:00","type":"Initial Filing","status":"Approved","entry_type":"Paper Filed","filing_number":"0003299074"}],"formation_date":"2005-04-14T00:00:00","registered_agent":"Corporation Service Company","term_of_duration":"Perpetual","business_activity":"INTERNET COMMERCE","principal_address":{"city":"MOUNTAIN VIEW","state":"CA","street":"1600 AMPHITHEATRE PKWY","postal_code":"94043-1351"},"annual_report_due_date":"2027-06-30T00:00:00","registered_office_address":{"city":"Harrisburg","state":"PA","street":"5235 NORTH FRONT STREET","postal_code":"17110"}},"status":"success"}},"initiates_session":false,"price":3,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.entity_number","op":"not_null"},{"path":"$.data.entity_name","op":"not_null"},{"path":"$.data.entity_type","op":"not_null"},{"path":"$.data.filing_history","op":"array_min_len","value":1}],"empty_is_valid":false,"recipe_version":1}}],"sample_inputs":{"search_entities":{"query":"GOOGLE","search_type":"starts_with"},"get_entity_details":{"entity_number":"0001038534"}},"prefill_inputs":{"search_entities":{"query":"GOOGLE","search_type":"starts_with"}},"last_verified_at":null,"endpoint_health":[{"endpoint_name":"search_entities","status":"ambiguous","last_checked_at":"2026-11-02T15:03:52.945262+00:00","last_verified_at":"2026-09-16T01:01:52.883737+00:00","recent_runs":[{"at":"2026-11-02T15:03:52.945262+00:00","status":"ambiguous"},{"at":"2026-11-02T12:03:53.058909+00:00","status":"ambiguous"},{"at":"2026-11-02T10:01:52.933941+00:00","status":"ambiguous"},{"at":"2026-11-02T09:00:25.414791+00:00","status":"ambiguous"},{"at":"2026-11-02T07:05:52.920681+00:00","status":"ambiguous"},{"at":"2026-11-02T05:03:52.936447+00:00","status":"ambiguous"},{"at":"2026-11-02T03:04:25.246139+00:00","status":"ambiguous"},{"at":"2026-11-02T02:02:52.929945+00:00","status":"ambiguous"},{"at":"2026-11-02T00:04:52.903671+00:00","status":"ambiguous"},{"at":"2026-11-01T22:04:25.222142+00:00","status":"ambiguous"},{"at":"2026-11-01T20:03:52.905385+00:00","status":"ambiguous"},{"at":"2026-11-01T19:02:52.947496+00:00","status":"ambiguous"},{"at":"2026-11-01T17:04:25.252703+00:00","status":"ambiguous"},{"at":"2026-11-01T16:01:52.914721+00:00","status":"ambiguous"}]},{"endpoint_name":"get_entity_details","status":"blocked","last_checked_at":"2026-11-02T15:03:52.945262+00:00","last_verified_at":"2026-09-16T01:01:52.883737+00:00","recent_runs":[{"at":"2026-11-02T15:03:52.945262+00:00","status":"blocked"},{"at":"2026-11-02T12:03:53.058909+00:00","status":"blocked"},{"at":"2026-11-02T10:01:52.933941+00:00","status":"blocked"},{"at":"2026-11-02T09:00:25.414791+00:00","status":"blocked"},{"at":"2026-11-02T07:05:52.920681+00:00","status":"blocked"},{"at":"2026-11-02T05:03:52.936447+00:00","status":"blocked"},{"at":"2026-11-02T03:04:25.246139+00:00","status":"blocked"},{"at":"2026-11-02T02:02:52.929945+00:00","status":"blocked"},{"at":"2026-11-02T00:04:52.903671+00:00","status":"blocked"},{"at":"2026-11-01T22:04:25.222142+00:00","status":"blocked"},{"at":"2026-11-01T20:03:52.905385+00:00","status":"blocked"},{"at":"2026-11-01T19:02:52.947496+00:00","status":"blocked"},{"at":"2026-11-01T17:04:25.252703+00:00","status":"blocked"},{"at":"2026-11-01T16:01:52.914721+00:00","status":"blocked"}]}],"sdk_usage_example":{"code":"\"\"\"Walkthrough: PA Business Entity Search — search, navigate, and inspect details.\"\"\"\nfrom parse_apis.file_dos_pa_gov_api import PaBusinessSearch, SearchType, EntityNotFound\n\nclient = PaBusinessSearch()\n\n# Search for entities whose name starts with a keyword; cap total items.\nfor summary in client.entity_summaries.search(query=\"GOOGLE\", search_type=SearchType.STARTS_WITH, limit=5):\n    print(summary.entity_name, summary.entity_type, summary.standing)\n\n# Drill into the first match's full details via summary-to-detail navigation.\nhit = client.entity_summaries.search(query=\"GOOGLE\", limit=1).first()\nif hit is not None:\n    detail = hit.details()\n    print(detail.entity_name, detail.status, detail.jurisdiction)\n    print(\"Business activity:\", detail.business_activity)\n    print(\"Formation:\", detail.formation_date)\n\n    # Walk nested typed objects: officers and filing history.\n    for officer in detail.officers:\n        print(\"  Officer:\", officer.name, officer.role)\n    for filing in detail.filing_history:\n        print(\"  Filing:\", filing.type, filing.date, filing.status)\n\n    # Registered office address (nullable — guard before access).\n    if detail.registered_office_address is not None:\n        addr = detail.registered_office_address\n        print(\"  Office:\", addr.street, addr.city, addr.state, addr.postal_code)\n\n# Point lookup by entity number discovered from a prior search result.\nif hit is not None:\n    try:\n        entity = client.entities.get(entity_number=hit.entity_number)\n        print(entity.entity_name, entity.standing, entity.term_of_duration)\n    except EntityNotFound:\n        print(\"Entity not found for\", hit.entity_number)\n\nprint(\"exercised: entity_summaries.search / EntitySummary.details / entities.get\")\n","endpoints":["search_entities","get_entity_details"],"has_session":false,"shape":"parse_sdk","hover_map":[{"line":7,"col":4,"len":7,"label":"summary: EntitySummary","kind":"variable"},{"line":11,"col":0,"len":3,"label":"hit: EntitySummary","kind":"variable"},{"line":4,"col":9,"len":16,"label":"PaBusinessSearch — API client","kind":"class"},{"line":7,"col":39,"len":6,"label":"search() → List[EntitySummary]","kind":"method"},{"line":12,"col":3,"len":3,"label":"hit: EntitySummary","kind":"variable"},{"line":13,"col":4,"len":6,"label":"detail: Entity","kind":"variable"},{"line":19,"col":8,"len":7,"label":"officer: Officer","kind":"variable"},{"line":19,"col":26,"len":8,"label":"officers: List[Officer]","kind":"field"},{"line":21,"col":8,"len":6,"label":"filing: Filing","kind":"variable"},{"line":21,"col":25,"len":14,"label":"filing_history: List[Filing]","kind":"field"},{"line":30,"col":3,"len":3,"label":"hit: EntitySummary","kind":"variable"},{"line":7,"col":85,"len":11,"label":"SearchType.STARTS_WITH","kind":"enum-member"},{"line":8,"col":18,"len":11,"label":"entity_name: str","kind":"field"},{"line":8,"col":39,"len":11,"label":"entity_type: str","kind":"field"},{"line":8,"col":60,"len":8,"label":"standing: str","kind":"field"},{"line":13,"col":17,"len":7,"label":"details() → Entity","kind":"method"},{"line":14,"col":17,"len":11,"label":"entity_name: str","kind":"field"},{"line":14,"col":37,"len":6,"label":"status: str","kind":"field"},{"line":14,"col":52,"len":12,"label":"jurisdiction: str","kind":"field"},{"line":15,"col":39,"len":17,"label":"business_activity: str","kind":"field"},{"line":16,"col":31,"len":14,"label":"formation_date: datetime","kind":"field"},{"line":19,"col":19,"len":6,"label":"detail: Entity","kind":"variable"},{"line":21,"col":18,"len":6,"label":"detail: Entity","kind":"variable"},{"line":25,"col":14,"len":25,"label":"registered_office_address: Optional[Address]","kind":"field"},{"line":26,"col":8,"len":4,"label":"addr: Address","kind":"variable"},{"line":26,"col":22,"len":25,"label":"registered_office_address: Optional[Address]","kind":"field"},{"line":34,"col":11,"len":14,"label":"EntityNotFound — error: The requested entity number does not exist in the PA business registry","kind":"error"},{"line":7,"col":74,"len":10,"label":"SearchType — enum: CONTAINS, STARTS_WITH","kind":"enum"},{"line":8,"col":10,"len":7,"label":"summary: EntitySummary","kind":"variable"},{"line":8,"col":31,"len":7,"label":"summary: EntitySummary","kind":"variable"},{"line":8,"col":52,"len":7,"label":"summary: EntitySummary","kind":"variable"},{"line":11,"col":30,"len":6,"label":"search() → List[EntitySummary]","kind":"method"},{"line":13,"col":13,"len":3,"label":"hit: EntitySummary","kind":"variable"},{"line":14,"col":10,"len":6,"label":"detail: Entity","kind":"variable"},{"line":14,"col":30,"len":6,"label":"detail: Entity","kind":"variable"},{"line":14,"col":45,"len":6,"label":"detail: Entity","kind":"variable"},{"line":15,"col":32,"len":6,"label":"detail: Entity","kind":"variable"},{"line":16,"col":24,"len":6,"label":"detail: Entity","kind":"variable"},{"line":20,"col":36,"len":4,"label":"name: str","kind":"field"},{"line":20,"col":50,"len":4,"label":"role: str","kind":"field"},{"line":22,"col":34,"len":4,"label":"type: str","kind":"field"},{"line":22,"col":47,"len":4,"label":"date: datetime","kind":"field"},{"line":22,"col":60,"len":6,"label":"status: str","kind":"field"},{"line":25,"col":7,"len":6,"label":"detail: Entity","kind":"variable"},{"line":26,"col":15,"len":6,"label":"detail: Entity","kind":"variable"},{"line":27,"col":32,"len":6,"label":"street: str","kind":"field"},{"line":27,"col":45,"len":4,"label":"city: str","kind":"field"},{"line":27,"col":56,"len":5,"label":"state: str","kind":"field"},{"line":27,"col":68,"len":11,"label":"postal_code: str","kind":"field"},{"line":20,"col":28,"len":7,"label":"officer: Officer","kind":"variable"},{"line":20,"col":42,"len":7,"label":"officer: Officer","kind":"variable"},{"line":22,"col":27,"len":6,"label":"filing: Filing","kind":"variable"},{"line":22,"col":40,"len":6,"label":"filing: Filing","kind":"variable"},{"line":22,"col":53,"len":6,"label":"filing: Filing","kind":"variable"},{"line":27,"col":27,"len":4,"label":"addr: Address","kind":"variable"},{"line":27,"col":40,"len":4,"label":"addr: Address","kind":"variable"},{"line":27,"col":51,"len":4,"label":"addr: Address","kind":"variable"},{"line":27,"col":63,"len":4,"label":"addr: Address","kind":"variable"},{"line":32,"col":55,"len":13,"label":"entity_number: str","kind":"field"},{"line":35,"col":42,"len":13,"label":"entity_number: str","kind":"field"},{"line":32,"col":51,"len":3,"label":"hit: EntitySummary","kind":"variable"},{"line":35,"col":38,"len":3,"label":"hit: EntitySummary","kind":"variable"}]},"sdk_delivery_state":"available","summary":"Search and retrieve Pennsylvania Department of State business entity records including registration details, officers, and filing history.","updated_at":"2026-09-01T22:14:27.968301+00:00","user_variants":[],"latest_version":1,"user_status":null,"user_scraper_id":null,"contributes_to_marketplace":true,"pinned_version":null,"seo_content":{"faqs":[{"a":"The Pennsylvania Department of State does not publish a documented public developer API for business entity searches. The data is made available through the public search portal at file.dos.pa.gov/search/business.","q":"Does the Pennsylvania Department of State provide an official developer API for this data?"},{"a":"The `officers` array returns one object per listed officer or governor, each containing the individual's name, their title (e.g., President, Secretary, Manager), and their role designation as recorded with the Department of State. It reflects whoever is on file at the time of the request — it does not include historical officer appointments that have since been removed.","q":"What does the officers array in get_entity_details actually contain?"},{"a":"Yes. The `get_entity_details` response distinguishes between the registered office address (used for legal and official correspondence) and the principal office address (the main place of business). Both are returned when on file with the Department of State.","q":"Can I retrieve registered office address and principal office address separately?"},{"a":"Not currently. The API covers business entity registration records — searches and detailed entity profiles including officers, standing, and filing history. UCC filings, charitable organization registrations, and professional license data are separate Pennsylvania DOS systems not included in these endpoints. You can fork this API on Parse and revise it to add endpoints targeting those other record types.","q":"Does the API cover Pennsylvania UCC filings, charity registrations, or professional licenses?"},{"a":"The current `search_entities` endpoint returns all matching entities for a given query in a single response, along with a `total_results` count. There is no pagination parameter exposed. For very broad queries, using `starts_with` mode or a more specific query string will narrow results. You can fork this API on Parse and revise it to add pagination parameters if the source supports them.","q":"Is there a way to paginate through large result sets from search_entities?"}],"keywords":["Pennsylvania business entity search API","PA Department of State business lookup","Pennsylvania LLC registration details API","PA business entity status and standing","Pennsylvania business filing history API","PA registered agent lookup","Pennsylvania corporation officer search","PA DOS entity number lookup","Pennsylvania foreign business corporation API","PA business registry API","Pennsylvania entity formation date API","PA good standing verification API","Pennsylvania business due diligence API","PA DOS entity type and jurisdiction data"],"use_cases":["Verify good standing and active status of a Pennsylvania vendor before contract execution","Retrieve officer and governor names for a PA-registered LLC during a KYC or background check workflow","Enumerate all filings by type and date for a business entity to assess compliance history","Identify the registered agent on record for legal service or correspondence purposes","Bulk-search entities by name fragment using 'contains' mode to find related companies under a common brand","Cross-reference jurisdiction field to distinguish domestic PA entities from foreign entities registered in PA","Automate monitoring of entity status changes by periodically fetching details via entity number"],"meta_title":"Pennsylvania DOS Business Search API","generated_at":"2026-09-01T22:15:41.183223+00:00","lead_paragraph":"This API provides access to Pennsylvania Department of State business entity data through 2 endpoints. Use `search_entities` to query the statewide business registry by name or entity number, returning status, entity type, jurisdiction, and standing for every match. Use `get_entity_details` to pull a full record for a specific entity, including registered agent, principal address, officers, and a complete filing history.","schema_version":2,"meta_description":"Search and retrieve Pennsylvania Department of State business entity records including registration details, officers, addresses, and filing history via two REST endpoints.","primary_category":"government_public","long_description_md":"## Searching the Pennsylvania Business Registry\n\nThe `search_entities` endpoint accepts a `query` string (entity name or entity number) and an optional `search_type` parameter that controls whether results match on `starts_with` or `contains`. The response includes an array of matching entities, each carrying the entity number, name, entity type (e.g., Domestic Limited Liability Company, Foreign Business Corporation), current status, initial filing date, jurisdiction, and standing. The `total_results` field tells you how many records matched without needing to count the array.\n\n## Retrieving Full Entity Details\n\nThe `get_entity_details` endpoint takes a 10-digit zero-padded `entity_number` — the same value returned in `search_entities` results. Shorter numeric strings are automatically padded. The response includes the official `entity_name`, `entity_type`, `formation_date` in ISO format, `jurisdiction`, `status`, `standing`, `registered_agent` name, and two address fields for the registered office and principal location. The `officers` array lists each officer or governor with their name, title, and role. The `filing_history` array provides every recorded filing entry with its type, date, status, and Document Locator Number (DLN).\n\n## Data Coverage and Scope\n\nData reflects Pennsylvania Department of State records for domestic and foreign business entities registered to operate in Pennsylvania. Entity types span corporations, LLCs, LPs, LLPs, and other recognized forms. Status values include Active and Inactive variants such as \"Inactive - Withdrawn\". The filing history gives a full chronological view of document submissions, making it useful for due diligence and compliance workflows.","generated_with_model":"global.anthropic.claude-sonnet-4-6","secondary_categories":["b2b_directory","finance"]},"primary_category":"government_public","secondary_categories":["b2b_directory","finance"],"access_requirements":[]}