{"id":"b04438da-b5a6-4b14-9cfb-37160e61995a","slug":"arc-sos-state-al-us-api","name":"arc-sos.state.al.us API","description":"API for the Alabama Secretary of State business entity database (arc-sos.state.al.us). Supports retrieving full entity details by ID, searching entities by name or associated contacts (agents, officers, incorporators), bulk-scanning entity ID ranges, and checking entity existence.","front_facing_description":"Search and retrieve detailed information about Alabama business entities, including their registration status, agents, officers, and incorporators. Verify if a business exists and look up specific company details by name or associated contacts.","source_url":"https://arc-sos.state.al.us","is_authenticated":false,"canonical_scraper_id":"8751016c-86ae-408f-bf0b-fdbd6ff3163d","apis":[{"method":"GET","endpoint_name":"get_entity_detail","description":"Get detailed information for a specific business entity by its 9-digit ID. Returns entity details including legal name, type, status, formation date, registered agent, addresses, transactions, and scanned documents. Each entity has a unique 9-digit identifier with preserved leading zeros.","input_params":{"entity_id":{"type":"string","required":true,"description":"The 9-digit entity ID, leading zeros preserved (e.g., 000210236).","domain":{"kind":"large_enum","example":"000210236","pattern":"^\\d{9}$","generator":{"type":"static","value":"000210236"}}}},"return_schema":{"type":"object","fields":{"status":"string, entity status (e.g., Exists, Dissolved)","entity_id":"string, 9-digit entity ID","legal_name":"string, legal name of the entity","entity_type":"string, type of entity (e.g., Domestic Corporation)","transactions":"array of transaction objects with date, description, and value","formation_date":"string, formation date in MM/DD/YYYY format","principal_address":"string, principal office address","scanned_documents":"array of document objects with date, type, and pages","nature_of_business":"string, description of business activity","place_of_formation":"string, place or county of formation","registered_agent_name":"string, name of registered agent"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.entity_id","op":"not_null"},{"path":"$.data.legal_name","op":"not_null"}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"search_by_entity_name","description":"Search for business entities by name. Returns up to 25 results per page with entity ID, name, location, type, and status. Pagination is supported via the start parameter which advances by 25 per page.","input_params":{"name":{"type":"string","required":true,"description":"Search query for entity name.","domain":{"kind":"open","example":"Alabama","generator":{"type":"static","value":"Alabama"}}},"start":{"type":"integer","required":false,"description":"Starting index for pagination (1-based, advances by 25 per page).","default":1,"domain":{"kind":"open","generator":{"type":"static","value":1}}}},"return_schema":{"type":"object","fields":{"items":"array of entity objects with entity_id, entity_name, location, entity_type, and status","total":"integer, number of results returned"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.items","op":"array_min_len","value":1}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"search_by_agent_officer_incorporator","description":"Search for business entities by registered agent, officer, or incorporator name. Returns up to 25 results per page with entity ID, entity name, agent name, and position.","input_params":{"name":{"type":"string","required":true,"description":"Name of the agent, officer, or incorporator.","domain":{"kind":"open","example":"Smith","generator":{"type":"static","value":"Smith"}}}},"return_schema":{"type":"object","fields":{"items":"array of entity objects with entity_id, entity_name, agent_name, and position","total":"integer, number of results returned"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.items","op":"array_min_len","value":1}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"scrape_entity_range","description":"Retrieve full entity details for a sequential range of entity IDs. Optionally filter results to only entities whose formation date falls within January 2024 to July 2025. Range is capped at 50 entities per call.","input_params":{"end_id":{"type":"string","required":false,"description":"Ending entity ID in the range (9-digit, leading zeros preserved).","domain":{"kind":"large_enum","example":"001117003","pattern":"^\\d{9}$","generator":{"type":"static","value":"001117003"}}},"start_id":{"type":"string","required":false,"description":"Starting entity ID in the range (9-digit, leading zeros preserved).","domain":{"kind":"large_enum","example":"001117000","pattern":"^\\d{9}$","generator":{"type":"static","value":"001117000"}}},"filter_dates":{"type":"boolean","required":false,"description":"When true, filters results to entities whose formation date falls within January 2024 to July 2025.","default":true,"domain":{"kind":"open","generator":{"type":"static","value":false}}}},"return_schema":{"type":"object","fields":{"count":"integer, number of entities returned","items":"array of full entity detail objects"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.items","op":"array_min_len","value":1}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"check_entity_exists","description":"Check if a specific entity ID exists in the Alabama Secretary of State database. Returns a boolean existence flag and the queried entity ID.","input_params":{"entity_id":{"type":"string","required":true,"description":"The 9-digit entity ID, leading zeros preserved.","domain":{"kind":"large_enum","example":"000210236","pattern":"^\\d{9}$","generator":{"type":"static","value":"000210236"}}}},"return_schema":{"type":"object","fields":{"exists":"boolean, whether the entity exists","entity_id":"string, the queried entity ID"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.entity_id","op":"not_null"},{"path":"$.data.exists","op":"not_null"}],"empty_is_valid":false,"recipe_version":1}}],"sample_inputs":{"get_entity_detail":{"entity_id":"000210236"},"check_entity_exists":{"entity_id":"000210236"},"scrape_entity_range":{"end_id":"001117003","start_id":"001117000","filter_dates":"False"},"search_by_entity_name":{"name":"Alabama","start":"1"},"search_by_agent_officer_incorporator":{"name":"Smith"}},"prefill_inputs":{"get_entity_detail":{"entity_id":"000210236"},"search_by_entity_name":{"name":"Alabama","start":"1"},"search_by_agent_officer_incorporator":{"name":"Smith"},"scrape_entity_range":{"end_id":"001117003","start_id":"001117000","filter_dates":"False"},"check_entity_exists":{"entity_id":"000210236"}},"last_verified_at":"2026-10-29T22:00:26.052344+00:00","endpoint_health":[{"endpoint_name":"search_by_entity_name","status":"healthy","last_checked_at":"2026-10-29T22:00:26.052344+00:00","last_verified_at":"2026-10-29T22:00:26.052344+00:00","recent_runs":[{"at":"2026-10-29T22:00:26.052344+00:00","status":"healthy"},{"at":"2026-10-22T19:04:25.738171+00:00","status":"healthy"},{"at":"2026-10-15T13:03:52.943855+00:00","status":"healthy"},{"at":"2026-10-08T12:02:25.246145+00:00","status":"healthy"},{"at":"2026-10-01T11:00:59.996921+00:00","status":"healthy"}]},{"endpoint_name":"get_entity_detail","status":"healthy","last_checked_at":"2026-10-29T22:00:26.052344+00:00","last_verified_at":"2026-10-29T22:00:26.052344+00:00","recent_runs":[{"at":"2026-10-29T22:00:26.052344+00:00","status":"healthy"},{"at":"2026-10-22T19:04:25.738171+00:00","status":"healthy"},{"at":"2026-10-15T13:03:52.943855+00:00","status":"healthy"},{"at":"2026-10-08T12:02:25.246145+00:00","status":"healthy"},{"at":"2026-10-01T11:00:59.996921+00:00","status":"healthy"}]},{"endpoint_name":"search_by_agent_officer_incorporator","status":"healthy","last_checked_at":"2026-10-29T22:00:26.052344+00:00","last_verified_at":"2026-10-29T22:00:26.052344+00:00","recent_runs":[{"at":"2026-10-29T22:00:26.052344+00:00","status":"healthy"},{"at":"2026-10-22T19:04:25.738171+00:00","status":"healthy"},{"at":"2026-10-15T13:03:52.943855+00:00","status":"healthy"},{"at":"2026-10-08T12:02:25.246145+00:00","status":"healthy"},{"at":"2026-10-01T11:00:59.996921+00:00","status":"healthy"}]},{"endpoint_name":"scrape_entity_range","status":"healthy","last_checked_at":"2026-10-29T22:00:26.052344+00:00","last_verified_at":"2026-10-29T22:00:26.052344+00:00","recent_runs":[{"at":"2026-10-29T22:00:26.052344+00:00","status":"healthy"},{"at":"2026-10-22T19:04:25.738171+00:00","status":"healthy"},{"at":"2026-10-15T13:03:52.943855+00:00","status":"healthy"},{"at":"2026-10-08T12:02:25.246145+00:00","status":"healthy"},{"at":"2026-10-01T11:00:59.996921+00:00","status":"healthy"}]},{"endpoint_name":"check_entity_exists","status":"healthy","last_checked_at":"2026-10-29T22:00:26.052344+00:00","last_verified_at":"2026-10-29T22:00:26.052344+00:00","recent_runs":[{"at":"2026-10-29T22:00:26.052344+00:00","status":"healthy"},{"at":"2026-10-22T19:04:25.738171+00:00","status":"healthy"},{"at":"2026-10-15T13:03:52.943855+00:00","status":"healthy"},{"at":"2026-10-08T12:02:25.246145+00:00","status":"healthy"},{"at":"2026-10-01T11:00:59.996921+00:00","status":"healthy"}]}],"sdk_usage_example":{"code":"\"\"\"Walkthrough: Alabama Secretary of State Business Search — bounded, re-runnable.\"\"\"\nfrom parse_apis.alabama_secretary_of_state_business_search_api import (\n    AlabamaSOS,\n    EntityNotFound,\n)\n\nclient = AlabamaSOS()\n\n# Search entities by name — limit caps total items fetched.\nfor summary in client.entitysummaries.search(name=\"Alabama\", limit=3):\n    print(summary.entity_name, summary.location, summary.status)\n\n# Drill into one result for full details.\nfirst = client.entitysummaries.search(name=\"Alabama\", limit=1).first()\nif first:\n    entity = first.details()\n    print(entity.legal_name, entity.formation_date, entity.entity_type)\n    for doc in entity.scanned_documents:\n        print(doc.date, doc.type, doc.pages)\n\n# Search by agent/officer/incorporator name.\nfor agent_hit in client.agentresults.search(name=\"Smith\", limit=3):\n    print(agent_hit.entity_name, agent_hit.agent_name, agent_hit.position)\n\n# Fetch an entity directly by ID with typed-error handling.\ntry:\n    detail = client.entities.get(entity_id=\"000210236\")\n    print(detail.legal_name, detail.status, detail.nature_of_business)\n    for tx in detail.transactions:\n        print(tx.date, tx.description)\nexcept EntityNotFound as exc:\n    print(f\"Entity not found: {exc.entity_id}\")\n\n# Batch fetch a range of entities.\nfor ent in client.entities.list_range(start_id=\"001117000\", end_id=\"001117002\", filter_dates=False, limit=3):\n    print(ent.entity_id, ent.legal_name, ent.formation_date)\n\nprint(\"exercised: entitysummaries.search / details / agentresults.search / entities.get / entities.list_range\")\n","shape":"parse_sdk","endpoints":["get_entity_detail","search_by_entity_name","search_by_agent_officer_incorporator","scrape_entity_range","check_entity_exists"],"has_session":false,"hover_map":[{"line":35,"col":4,"len":3,"label":"ent: Entity","kind":"variable"},{"line":7,"col":9,"len":10,"label":"AlabamaSOS — API client","kind":"class"},{"line":16,"col":4,"len":6,"label":"entity: Entity","kind":"variable"},{"line":18,"col":8,"len":3,"label":"doc: Document","kind":"variable"},{"line":18,"col":22,"len":17,"label":"scanned_documents: List[Document]","kind":"field"},{"line":31,"col":7,"len":14,"label":"EntityNotFound — error (422): The requested entity ID does not exist in the database","kind":"error"},{"line":35,"col":27,"len":10,"label":"list_range() → List[Entity]","kind":"method"},{"line":16,"col":19,"len":7,"label":"details() → Entity","kind":"method"},{"line":17,"col":17,"len":10,"label":"legal_name: str","kind":"field"},{"line":17,"col":36,"len":14,"label":"formation_date: str","kind":"field"},{"line":17,"col":59,"len":11,"label":"entity_type: str","kind":"field"},{"line":18,"col":15,"len":6,"label":"entity: Entity","kind":"variable"},{"line":36,"col":14,"len":9,"label":"entity_id: str","kind":"field"},{"line":36,"col":29,"len":10,"label":"legal_name: str","kind":"field"},{"line":36,"col":45,"len":14,"label":"formation_date: str","kind":"field"},{"line":17,"col":10,"len":6,"label":"entity: Entity","kind":"variable"},{"line":17,"col":29,"len":6,"label":"entity: Entity","kind":"variable"},{"line":17,"col":52,"len":6,"label":"entity: Entity","kind":"variable"},{"line":19,"col":18,"len":4,"label":"date: str","kind":"field"},{"line":19,"col":28,"len":4,"label":"type: str","kind":"field"},{"line":19,"col":38,"len":5,"label":"pages: str","kind":"field"},{"line":36,"col":10,"len":3,"label":"ent: Entity","kind":"variable"},{"line":36,"col":25,"len":3,"label":"ent: Entity","kind":"variable"},{"line":36,"col":41,"len":3,"label":"ent: Entity","kind":"variable"},{"line":19,"col":14,"len":3,"label":"doc: Document","kind":"variable"},{"line":19,"col":24,"len":3,"label":"doc: Document","kind":"variable"},{"line":19,"col":34,"len":3,"label":"doc: Document","kind":"variable"},{"line":32,"col":31,"len":3,"label":"exc: EntityNotFound","kind":"variable"}]},"sdk_delivery_state":"legacy","summary":"Search and retrieve business entity details from the Alabama Secretary of State database.","updated_at":"2026-07-23T02:19:11.210997+00:00","user_variants":[],"latest_version":6,"user_status":null,"user_scraper_id":null,"contributes_to_marketplace":true,"pinned_version":null,"seo_content":{"faqs":[{"a":"No. The Alabama Secretary of State does not publish an official public developer API for its business entity registry. This Parse API provides structured programmatic access to the same records.","q":"Does the Alabama Secretary of State provide an official developer API for arc-sos.state.al.us?"},{"a":"In addition to `legal_name`, `status`, and `entity_type`, the endpoint returns a `transactions` array (each entry has a date, description, and value), a `scanned_documents` array (each entry includes document type, date, and page count), `nature_of_business`, `principal_address`, and `place_of_formation`. It does not return officer or incorporator names directly — those require a separate call to `search_by_agent_officer_incorporator`.","q":"What does get_entity_detail return beyond basic registration info?"},{"a":"Results are returned in pages of up to 25 entities. Use the `start` parameter with 1-based indexing: `start=1` for the first page, `start=26` for the second, `start=51` for the third, and so on. The `total` field in the response reflects how many results were returned on the current page, not the total count across all pages.","q":"How does pagination work in search_by_entity_name?"},{"a":"No. The API covers only entities registered with the Alabama Secretary of State. Foreign entities that have registered to do business in Alabama will appear (their `place_of_formation` will reflect their home state), but businesses registered solely in other states are not included. You can fork this API on Parse and revise it to add endpoints targeting other state business registries.","q":"Does the API cover business entities from other U.S. states?"},{"a":"Yes. The range is capped at 50 entities per call. If your `start_id` and `end_id` span more than 50 IDs, you will need to paginate by adjusting the range across multiple requests. The `filter_dates` boolean can reduce the returned set further by limiting results to entities formed between January 2024 and July 2025.","q":"Is there a limit on how many entities scrape_entity_range can return in one call?"}],"keywords":["Alabama Secretary of State business entity API","Alabama business registration lookup API","arc-sos.state.al.us API","Alabama registered agent search API","Alabama corporation status check API","Alabama business entity ID lookup","Alabama incorporator officer search","Alabama business formation date API","Alabama Secretary of State public records API","Alabama domestic corporation dissolved status","Alabama business entity transaction history","Alabama SOS entity name search API","Alabama business entity range scrape"],"use_cases":["Verify whether an Alabama business entity is active or dissolved before entering a contract","Map all entities associated with a specific registered agent using search_by_agent_officer_incorporator","Build a database of recently formed Alabama businesses by scanning ID ranges with filter_dates enabled","Look up the principal address and nature of business for due diligence on a counterparty","Retrieve transaction history for an entity to track filing and status-change activity over time","Check which officers or incorporators are shared across multiple Alabama business entities","Enumerate scanned document records for a company to identify available filings by type and date"],"meta_title":"Alabama Secretary of State Business API","generated_at":"2026-06-09T14:00:37.867989+00:00","lead_paragraph":"This API provides access to the Alabama Secretary of State business entity database across 5 endpoints, returning up to 25 fields per entity including legal name, formation date, registered agent, status, transaction history, and scanned document metadata. The `get_entity_detail` endpoint retrieves a full profile for any entity by its 9-digit ID, while `search_by_entity_name` and `search_by_agent_officer_incorporator` let you find entities by name or associated persons.","schema_version":2,"meta_description":"Search and retrieve Alabama business entity records from arc-sos.state.al.us. Get entity details, registration status, agents, officers, and formation dates.","primary_category":"government_public","long_description_md":"## Entity Lookup and Search\n\nThe `get_entity_detail` endpoint accepts a 9-digit zero-padded entity ID (e.g., `000210236`) and returns the full record: `legal_name`, `entity_type`, `status` (such as Exists or Dissolved), `formation_date`, `principal_address`, `place_of_formation`, `nature_of_business`, a `transactions` array with date, description, and value per entry, and a `scanned_documents` array listing date, document type, and page count for each filing on record.\n\n## Name and Person Searches\n\n`search_by_entity_name` accepts a `name` query and an optional `start` parameter for 1-based pagination (each page returns up to 25 results). Each result includes `entity_id`, `entity_name`, `location`, `entity_type`, and `status`. `search_by_agent_officer_incorporator` searches by the name of a registered agent, officer, or incorporator, returning `entity_id`, `entity_name`, `agent_name`, and `position` (e.g., Registered Agent, President, Incorporator) for each match — useful for mapping individuals to the entities they are associated with.\n\n## Range Retrieval and Existence Check\n\n`scrape_entity_range` fetches full entity details for a sequential block of IDs, capped at 50 entities per call. It accepts `start_id` and `end_id` as 9-digit strings and an optional `filter_dates` boolean that, when `true`, limits results to entities whose `formation_date` falls between January 2024 and July 2025. `check_entity_exists` takes a single entity ID and returns a `exists` boolean alongside the queried ID — useful for validating IDs before calling the more detailed endpoint.","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":[]}