{"id":"5da9bdd7-9d15-415d-bbed-fd07ea6d18dd","slug":"apps-dos-ny-gov-api","name":"apps.dos.ny.gov API","description":"apps.dos.ny.gov API","front_facing_description":"Access data from apps.dos.ny.gov.","source_url":"https://apps.dos.ny.gov/publicInquiry/","is_authenticated":false,"canonical_scraper_id":"8ceea6f9-34d2-4d7f-adf1-fc7bdd90b476","apis":[{"method":"GET","endpoint_name":"search_entities","description":"Search the NY DOS Corporation & Business Entity Database. Supports searching by entity name (with configurable match type: begins with, contains, or base word) or by DOS ID. Results can be filtered by entity status and entity type category. Returns paginated results with entity name, DOS ID, type, status, filing date, jurisdiction, and county. The upstream caps results at 300 entities per search; refine the query to find entities beyond that limit. Caller pagination uses page and limit (max 50 per page).","input_params":{"page":{"type":"integer","required":false,"description":"Page number for pagination (1-based).","default":1},"limit":{"type":"integer","required":false,"description":"Maximum number of results per page (max 50).","default":50},"query":{"type":"string","required":true,"description":"Entity name (at least 3 characters) or DOS ID to search for.","domain":{"kind":"open","example":"Apple","generator":{"type":"static","value":"Apple"}}},"status":{"type":"string","required":false,"description":"Filter results by entity status.","default":"all","enum":"EntityStatus","closed":true,"domain":{"kind":"enum","generator":{"type":"enum_pick","member":"ALL"},"exhaustive":true}},"match_type":{"type":"string","required":false,"description":"How to match the query against entity names. Only applicable when search_type is 'name'.","default":"begins_with","enum":"MatchType","closed":true,"domain":{"kind":"enum","generator":{"type":"enum_pick","member":"BEGINS_WITH"},"exhaustive":true}},"search_type":{"type":"string","required":false,"description":"Whether to search by entity name or DOS ID.","default":"name","enum":"SearchType","closed":true,"domain":{"kind":"enum","generator":{"type":"enum_pick","member":"NAME"},"exhaustive":true}},"entity_types":{"type":"string","required":false,"description":"Comma-separated list of entity type categories to include: Corporation, LimitedLiabilityCompany, LimitedPartnership, LimitedLiabilityPartnership. When omitted, all types are searched.","domain":{"kind":"open","example":"Corporation","generator":{"type":"static","value":"Corporation"}}}},"return_schema":{"type":"object","fields":{"page":"integer current page number","limit":"integer results per page","total":"integer total number of matching entities (capped at 300 by upstream)","entities":"array of entity objects with entity_name, dos_id, entity_type, entity_type_category, status, initial_filing_date, jurisdiction, county, assumed_name, assumed_name_id","result_indicator":"string indicating match status from upstream"},"sample":{"data":{"page":1,"limit":5,"total":300,"entities":[{"county":"Kings","dos_id":"1577981","status":"Inactive","entity_name":"APPLE & PEACHES, INC.","entity_type":"DOMESTIC BUSINESS CORPORATION","assumed_name":null,"jurisdiction":"New York, United States","assumed_name_id":null,"initial_filing_date":"1991-09-26T00:00:00","entity_type_category":"CORPORATION"}],"result_indicator":"EntityMatchFound"},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.entities","op":"array_min_len","value":1},{"path":"$.data.entities[*]","op":"field_present","value":"dos_id"},{"path":"$.data.entities[*]","op":"field_present","value":"entity_name"},{"path":"$.data.total","op":"type_is","value":"number"}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_entity_detail","description":"Retrieve full details for a specific entity by DOS ID. Returns general entity information (name, type, status, filing dates, jurisdiction, county), service of process address, registered agent, CEO/principal executive officer, principal executive office address, stock information, and filing history. Makes two requests: one for entity record detail and one for filing history. The dos_id is produced by search_entities.","input_params":{"dos_id":{"type":"string","required":true,"description":"The DOS ID of the entity, as returned by search_entities.","domain":{"kind":"derived","generator":{"path":"$.data.entities[*].dos_id","type":"derived","from_endpoint":"search_entities"}}}},"return_schema":{"type":"object","fields":{"county":"string NY county","dos_id":"string DOS ID","status":"string current status (Active, Inactive, etc.)","stock_info":"array or null of stock share objects with stock_type, stock_value, quantity","entity_name":"string entity name","entity_type":"string entity type description","jurisdiction":"string jurisdiction of formation","inactive_date":"string or null ISO date entity became inactive","filing_history":"array of filing history objects with file_date, document_type, amendment_description, page_count, file_number","section_of_law":"string or null section of law under which entity was formed","registered_agent":"object or null with name and address fields","statement_status":"string biennial statement status","reason_for_status":"string or null reason for current status","ceo_principal_executive":"object or null with name and address fields for CEO/principal executive officer","date_of_initial_dos_filing":"string ISO date of initial DOS filing","service_of_process_address":"object or null with name, street_address, city, state, zip_code, country","effective_date_initial_filing":"string ISO date effective date of initial filing","principal_executive_office_address":"object or null with address fields for principal executive office","electronic_service_of_process_status":"string electronic SOP status"},"sample":{"data":{"county":"Nassau","dos_id":"4888234","status":"Active","stock_info":[{"quantity":"200","stock_type":"NO PAR VALUE","stock_value":"0.00000"}],"entity_name":"1 APPLE CONSTRUCTION CORP.","entity_type":"DOMESTIC BUSINESS CORPORATION","jurisdiction":"New York, United States","nfp_category":null,"duration_date":null,"inactive_date":null,"farm_corp_flag":false,"filing_history":[{"file_date":"2025-01-31T15:03:52","page_count":"1","file_number":"250131003131","document_type":"BIENNIAL STATEMENT","amendment_description":"CHIEF EXECUTIVE OFFICER NAME/ADDRESS,PRINCIPAL EXECUTIVE OFFICE,SERVICE OF PROCESS"},{"file_date":"2016-01-29T00:00:00","page_count":"2","file_number":"160129010359","document_type":"CERTIFICATE OF INCORPORATION","amendment_description":null}],"section_of_law":"402 BCL - BUSINESS CORPORATION LAW","fictitious_name":null,"location_address":null,"registered_agent":null,"statement_status":"CURRENT","reason_for_status":null,"foreign_legal_name":null,"foreign_formation_date":null,"ceo_principal_executive":{"city":"BROO","name":"JESSICA RODRIGUEZ","state":"NY","country":"United States","zip_code":"11205","street_address":"500 DEKALB AVE","street_address_2":"STE 316"},"latest_date_dissolution":null,"next_statement_due_date":"2026-01-31T00:00:00","date_of_initial_dos_filing":"2016-01-29T00:00:00","service_of_process_address":{"city":"Broo","name":"JESSICA RODRIGUEZ","state":"NY","country":"United States","zip_code":"11205","street_address":"500 DeKalb Ave","street_address_2":"Ste 316"},"effective_date_initial_filing":"2016-01-29T00:00:00","principal_executive_office_address":{"city":"Brook","name":null,"state":"NY","country":"United States","zip_code":"11205","street_address":"500 DeKalb Ave","street_address_2":"Ste 317"},"electronic_service_of_process_email":null,"electronic_service_of_process_status":"Not Permitted"},"status":"success"}},"initiates_session":false,"price":2,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.entity_name","op":"not_null"},{"path":"$.data.dos_id","op":"not_null"},{"path":"$.data.entity_type","op":"not_null"},{"path":"$.data.status","op":"not_null"},{"path":"$.data.filing_history","op":"type_is","value":"array"}],"empty_is_valid":false,"recipe_version":1}}],"sample_inputs":{"search_entities":{"query":"Apple","status":"all","match_type":"begins_with","search_type":"name","entity_types":"Corporation"},"get_entity_detail":{"dos_id":"1577981"}},"prefill_inputs":{"search_entities":{"query":"Apple","status":"all","match_type":"begins_with","search_type":"name","entity_types":"Corporation"}},"last_verified_at":"2026-10-28T02:02:53.13471+00:00","endpoint_health":[{"endpoint_name":"search_entities","status":"healthy","last_checked_at":"2026-10-28T02:02:53.13471+00:00","last_verified_at":"2026-10-28T02:02:53.13471+00:00","recent_runs":[{"at":"2026-10-28T02:02:53.134710+00:00","status":"healthy"},{"at":"2026-10-21T01:03:52.910123+00:00","status":"healthy"},{"at":"2026-10-14T01:02:25.646416+00:00","status":"healthy"},{"at":"2026-10-07T00:04:25.223787+00:00","status":"healthy"},{"at":"2026-09-29T23:03:52.961462+00:00","status":"healthy"}]},{"endpoint_name":"get_entity_detail","status":"healthy","last_checked_at":"2026-10-28T02:02:53.13471+00:00","last_verified_at":"2026-10-28T02:02:53.13471+00:00","recent_runs":[{"at":"2026-10-28T02:02:53.134710+00:00","status":"healthy"},{"at":"2026-10-21T01:03:52.910123+00:00","status":"healthy"},{"at":"2026-10-14T01:02:25.646416+00:00","status":"healthy"},{"at":"2026-10-07T00:04:25.223787+00:00","status":"healthy"},{"at":"2026-09-29T23:03:52.961462+00:00","status":"healthy"}]}],"sdk_usage_example":{"code":"\"\"\"Walkthrough: NY DOS entity search and detail lookup, bounded and re-runnable.\"\"\"\nfrom parse_apis.apps_dos_ny_gov_api import NyDos, MatchType, EntityNotFound\n\nclient = NyDos()\n\n# Search for entities whose name begins with \"Apple\", cap total items fetched.\nfor summary in client.entity_summaries.search(query=\"Apple\", match_type=MatchType.BEGINS_WITH, limit=5):\n    print(summary.entity_name, summary.dos_id, summary.status)\n\n# Drill into the first result's full detail via .first() + navigation.\nhit = client.entity_summaries.search(query=\"Apple\", limit=1).first()\nif hit is not None:\n    entity = hit.details()\n    print(entity.entity_name, entity.entity_type, entity.status)\n    print(\"Filed:\", entity.date_of_initial_dos_filing, \"County:\", entity.county)\n\n    if entity.service_of_process_address is not None:\n        addr = entity.service_of_process_address\n        print(\"SOP:\", addr.name, addr.street_address, addr.city, addr.state, addr.zip_code)\n\n    for filing in entity.filing_history:\n        print(filing.file_date, filing.document_type, filing.file_number)\n\n    for stock in entity.stock_info or []:\n        print(stock.stock_type, stock.quantity)\n\n# Point lookup by a known DOS ID discovered from search.\nif hit is not None:\n    try:\n        detail = client.entities.get(dos_id=hit.dos_id)\n        print(detail.entity_name, detail.jurisdiction)\n    except EntityNotFound:\n        print(\"Entity not found for dos_id\", hit.dos_id)\n\nprint(\"exercised: entity_summaries.search / details / entities.get / filing_history / stock_info\")\n","endpoints":["search_entities","get_entity_detail"],"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":5,"label":"NyDos — 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":"entity: Entity","kind":"variable"},{"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":28,"col":3,"len":3,"label":"hit: EntitySummary","kind":"variable"},{"line":7,"col":82,"len":11,"label":"MatchType.BEGINS_WITH","kind":"enum-member"},{"line":8,"col":18,"len":11,"label":"entity_name: str","kind":"field"},{"line":8,"col":39,"len":6,"label":"dos_id: str","kind":"field"},{"line":8,"col":55,"len":6,"label":"status: 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":11,"label":"entity_type: str","kind":"field"},{"line":14,"col":57,"len":6,"label":"status: str","kind":"field"},{"line":15,"col":27,"len":26,"label":"date_of_initial_dos_filing: datetime","kind":"field"},{"line":15,"col":73,"len":6,"label":"county: str","kind":"field"},{"line":17,"col":14,"len":26,"label":"service_of_process_address: Optional[Address]","kind":"field"},{"line":18,"col":8,"len":4,"label":"addr: Address","kind":"variable"},{"line":18,"col":22,"len":26,"label":"service_of_process_address: Optional[Address]","kind":"field"},{"line":21,"col":18,"len":6,"label":"entity: Entity","kind":"variable"},{"line":24,"col":24,"len":10,"label":"stock_info: Optional[List[StockInfo]]","kind":"field"},{"line":32,"col":11,"len":14,"label":"EntityNotFound — error: The requested DOS ID does not match any entity","kind":"error"},{"line":7,"col":72,"len":9,"label":"MatchType — enum: BASE_WORD, BEGINS_WITH, CONTAINS","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":47,"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":"entity: Entity","kind":"variable"},{"line":14,"col":30,"len":6,"label":"entity: Entity","kind":"variable"},{"line":14,"col":50,"len":6,"label":"entity: Entity","kind":"variable"},{"line":15,"col":20,"len":6,"label":"entity: Entity","kind":"variable"},{"line":15,"col":66,"len":6,"label":"entity: Entity","kind":"variable"},{"line":17,"col":7,"len":6,"label":"entity: Entity","kind":"variable"},{"line":18,"col":15,"len":6,"label":"entity: Entity","kind":"variable"},{"line":19,"col":27,"len":4,"label":"name: Optional[str]","kind":"field"},{"line":19,"col":38,"len":14,"label":"street_address: str","kind":"field"},{"line":19,"col":59,"len":4,"label":"city: str","kind":"field"},{"line":19,"col":70,"len":5,"label":"state: str","kind":"field"},{"line":19,"col":82,"len":8,"label":"zip_code: str","kind":"field"},{"line":22,"col":21,"len":9,"label":"file_date: datetime","kind":"field"},{"line":22,"col":39,"len":13,"label":"document_type: str","kind":"field"},{"line":22,"col":61,"len":11,"label":"file_number: str","kind":"field"},{"line":24,"col":17,"len":6,"label":"entity: Entity","kind":"variable"},{"line":19,"col":22,"len":4,"label":"addr: Address","kind":"variable"},{"line":19,"col":33,"len":4,"label":"addr: Address","kind":"variable"},{"line":19,"col":54,"len":4,"label":"addr: Address","kind":"variable"},{"line":19,"col":65,"len":4,"label":"addr: Address","kind":"variable"},{"line":19,"col":77,"len":4,"label":"addr: Address","kind":"variable"},{"line":22,"col":14,"len":6,"label":"filing: Filing","kind":"variable"},{"line":22,"col":32,"len":6,"label":"filing: Filing","kind":"variable"},{"line":22,"col":54,"len":6,"label":"filing: Filing","kind":"variable"},{"line":30,"col":48,"len":6,"label":"dos_id: str","kind":"field"},{"line":33,"col":49,"len":6,"label":"dos_id: str","kind":"field"},{"line":30,"col":44,"len":3,"label":"hit: EntitySummary","kind":"variable"},{"line":33,"col":45,"len":3,"label":"hit: EntitySummary","kind":"variable"}]},"sdk_delivery_state":"available","summary":"Search the New York Department of State Corporation & Business Entity Database by entity name or DOS ID, and retrieve full entity details including filing history.","updated_at":"2026-09-01T20:57:59.890298+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":"No. The NY DOS does not publish an official developer API for its Corporation & Business Entity Database at apps.dos.ny.gov/publicInquiry/. This API provides structured programmatic access to that data.","q":"Does the New York Department of State offer an official developer API for this database?"},{"a":"The upstream source caps results at 300 total regardless of the actual match count. The `total` field in the response reflects this cap, not the true count of all matching entities. To narrow results below the cap, use the `match_type`, `status`, or `entity_types` filter parameters.","q":"What does search_entities return when there are more than 300 matching records?"},{"a":"No. The `filing_history` array returns metadata fields—`file_date`, `document_type`, `amendment_description`, `page_count`, and `file_number`—but not the actual document files or images. You can fork this API on Parse and revise it to add an endpoint that fetches associated document content.","q":"Does get_entity_detail return document images or PDF filings?"},{"a":"No. Coverage is limited to entities on file with the New York Department of State. The `jurisdiction` field can indicate that an entity was originally formed in another state, but only NY-registered entities are searchable. You can fork this API on Parse and revise it to target the equivalent public registry for other states.","q":"Does the API cover business entities from other US states?"},{"a":"The `entity_types` parameter accepts a comma-separated list of categories. Supported values include Corporation, LimitedLiabilityCompany, and LimitedPartnership, among others. Each entity in search results also carries an `entity_type` string (the specific legal type) and an `entity_type_category` (the broader group used for filtering).","q":"What entity types can be filtered in a search?"}],"keywords":["New York DOS business entity API","NY corporation search API","New York LLC lookup API","DOS ID entity search","NY Secretary of State business records API","New York business filing history API","registered agent lookup New York","NY corporation status check API","New York business entity database API","apps.dos.ny.gov API","NY DOS public inquiry API","business entity formation jurisdiction API","New York corporate records search"],"use_cases":["Verify whether a New York LLC or corporation is currently active before entering a business relationship","Look up the registered agent and service of process address for a specific entity by DOS ID","Retrieve filing history to track amendments, name changes, or dissolution events over time","Filter search results by entity type category (e.g., LimitedLiabilityCompany) and status to build a targeted business directory","Cross-reference CEO and principal executive officer data against other public records","Audit stock structure of a New York corporation using stock_type, stock_value, and quantity fields","Map entity jurisdiction and county fields to identify where New York-registered foreign entities are originally formed"],"meta_title":"NY DOS Business Entity Search API","generated_at":"2026-09-01T20:59:28.638962+00:00","lead_paragraph":"The NY DOS Business Entity API exposes 2 endpoints covering the New York Department of State's Corporation & Business Entity Database. Use `search_entities` to find companies by name or DOS ID with filters for status and entity type, and `get_entity_detail` to pull full records including filing history, registered agent, stock information, and principal executive officer data for any entity on file with New York State.","schema_version":2,"meta_description":"Search and retrieve New York Department of State corporation and business entity records, including filing history, registered agents, and officer info.","primary_category":"government_public","long_description_md":"## Search and Filter Business Entities\n\nThe `search_entities` endpoint accepts an entity name (minimum 3 characters) or a DOS ID as the `query` parameter. When searching by name, the `match_type` parameter controls matching behavior: `begins with`, `contains`, or `base word`. Results can be filtered by `status` (Active, Inactive, etc.) and narrowed to specific entity type categories—Corporation, LimitedLiabilityCompany, LimitedPartnership, and others—using the `entity_types` parameter as a comma-separated list. Responses are paginated up to 50 results per page and include fields like `entity_name`, `dos_id`, `entity_type`, `entity_type_category`, `status`, `initial_filing_date`, and `jurisdiction`. Note that the upstream source caps total results at 300 regardless of how many matches exist.\n\n## Full Entity Detail Records\n\nThe `get_entity_detail` endpoint takes a `dos_id` (as returned by `search_entities`) and returns a complete entity record. This includes general identifiers (`entity_name`, `entity_type`, `dos_id`, `status`, `jurisdiction`, `county`, `section_of_law`), key dates (`initial_filing_date`, `inactive_date`), and structured sub-objects for service of process address, registered agent, CEO/principal executive officer, and principal executive office address. Stock information is returned as an array of objects with `stock_type`, `stock_value`, and `quantity` fields, or null if not applicable.\n\n## Filing History\n\nThe `filing_history` array in `get_entity_detail` lists every document on record for the entity. Each entry includes `file_date`, `document_type`, `amendment_description`, `page_count`, and `file_number`. This makes it possible to reconstruct the lifecycle of an entity—from initial formation through amendments, mergers, or dissolution filings—using only the DOS ID.","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":[]}