arc-sos.state.al.us APIarc-sos.state.al.us ↗
Search and retrieve Alabama business entity records from arc-sos.state.al.us. Access registration status, agents, officers, formation dates, and filings.
curl -X GET 'https://api.parse.bot/scraper/8751016c-86ae-408f-bf0b-fdbd6ff3163d/get_entity_detail?entity_id=000963237' \ -H 'X-API-Key: $PARSE_API_KEY'
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.
| Param | Type | Description |
|---|---|---|
| entity_idrequired | string | The 9-digit entity ID, leading zeros preserved (e.g., 000210236). |
{
"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",
"scanned_documents": "array of document objects with date, type, and pages"
},
"sample": {
"data": {
"status": "Exists",
"entity_id": "000210236",
"legal_name": "ABC & 'D' Mortgage, Inc.",
"entity_type": "Domestic Corporation",
"transactions": [
{
"date": "10/30/2000",
"value": "NATIONAL REGISTERED AGENTS INC",
"description": "Registered Agent Changed From"
}
],
"formation_date": "05/30/2000",
"principal_address": "MONTGOMERY, AL",
"scanned_documents": [
{
"date": "05/30/2000",
"type": "Certificate of Formation",
"pages": "2 pgs."
}
],
"nature_of_business": "RESIDENTIAL MORTGAGE LENDING",
"place_of_formation": "Montgomery County",
"registered_agent_name": "CAPITOL CORPORATE SERVICES INC"
},
"status": "success"
}
}About the arc-sos.state.al.us API
This API provides access to 5 endpoints covering Alabama Secretary of State business entity records, returning details such as legal name, entity type, status, registered agent, formation date, and scanned documents. The get_entity_detail endpoint returns a full record for any 9-digit entity ID, while search_by_entity_name and search_by_agent_officer_incorporator support name-based lookups across the state registry.
Endpoints and Data Coverage
The API covers the Alabama Secretary of State's business entity registry through five endpoints. get_entity_detail accepts a 9-digit entity_id (leading zeros preserved, e.g., 000210236) and returns the full record: legal_name, entity_type, status (e.g., Exists or Dissolved), formation_date in MM/DD/YYYY format, a transactions array with dates and descriptions, and a scanned_documents array listing document type and page count. check_entity_exists takes the same ID format and returns a simple boolean exists field, useful for batch validation without fetching full records.
Search and Bulk Retrieval
search_by_entity_name accepts a name query and an optional 1-based start index for pagination, returning up to 25 results per page. Each result includes entity_id, entity_name, location, entity_type, and status. search_by_agent_officer_incorporator searches by a person's name across registered agent, officer, and incorporator roles, returning agent_name and position alongside the entity identifiers — useful for tracing individuals across multiple filings.
Range Retrieval and Filtering
scrape_entity_range accepts a start_id and end_id to retrieve full entity detail objects for a sequential block of up to 50 IDs per call. Setting filter_dates to true narrows results to entities whose formation_date falls within the requested window, which reduces noise when scanning for recently formed entities. The count field in the response reflects how many records were actually returned after filtering.
- Verify whether an Alabama business entity is currently active or dissolved before entering a contract.
- Build a database of registered agents operating in Alabama by querying
search_by_agent_officer_incorporatorwith agent names. - Identify all entities associated with a specific officer or incorporator using their name as the search query.
- Scan newly formed businesses in a date range using
scrape_entity_rangewithfilter_datesenabled. - Check for entity ID existence in bulk before fetching full records with
check_entity_exists. - Track filing history and transaction timelines for Alabama corporations using the
transactionsarray fromget_entity_detail. - Retrieve links to scanned formation documents and amendments for due diligence via the
scanned_documentsfield.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does the Alabama Secretary of State offer an official developer API for arc-sos.state.al.us?+
What does `get_entity_detail` return beyond basic registration info?+
get_entity_detail returns a transactions array listing dated events and descriptions on the entity's record, and a scanned_documents array with document type, date, and page count. It also returns formation_date, entity_type, status, and the entity's legal_name. Address and registered agent fields are included in the response as well.How does pagination work for name searches?+
search_by_entity_name returns up to 25 results per call. Use the start parameter (1-based integer) to page through results. The total field in the response reflects how many results were returned in that page, not the total count across all pages — plan your pagination logic accordingly.Does the API cover entities from other states or only Alabama?+
Does the API return officer lists or contact details for entity principals?+
get_entity_detail endpoint does not return a structured officer list or direct contact information. You can search by officer name using search_by_agent_officer_incorporator, which returns their position and associated entities. If you need a structured officer roster per entity, you can fork the API on Parse and revise get_entity_detail to parse and expose that field.