Documentation Index
Fetch the complete documentation index at: https://docs.topograph.co/llms.txt
Use this file to discover all available pages before exploring further.
Table of Contents
- Data Sources
- Company Identifiers
- Search Capabilities
- Quirks & Gotchas
- Mappings
- Data Availability
- Documents
- Example API Responses
Data Sources
All entity data comes from the Alabama Secretary of State — Business Entities Division via the ARC-SOS public portal (arc-sos.state.al.us). This is the official online search system for all corporations, limited liability companies, non-profit corporations, limited partnerships, general partnerships, and their foreign equivalents registered in Alabama. Every request hits the live register. There is no bulk data export or open-data feed. Responses are always authoritative and reflect the register’s current state.Alabama is a single-source integration. All data — company profile, legal
representatives, registered agent, and search — comes from the live Alabama
SoS portal. The Trade Register Extract is included at no extra charge with
the company data block.
Company Identifiers
Query Identifiers
| Identifier Type | Format | Example | Notes |
|---|---|---|---|
| Entity ID Number | 9-digit zero-padded integer. Accepted with or without dashes (000-358-845 or 000358845). Legacy 6-digit IDs (pre-2024) are accepted without padding. | 000358845 | Primary identifier assigned by Alabama SoS at registration |
Identifiers in API Response
| Identifier | Format | Example | Found In |
|---|---|---|---|
entityId | NNNNNNNNN | 000358845 | All entities |
Search Capabilities
| Search Type | Pattern | Example | Match Type | Expected Results |
|---|---|---|---|---|
| By Name | 2–200 chars | "Alabama Holdings" | Starts with | Multiple results |
| By Entity ID | 1–9 digits | 000358845 | Exact | Single entity |
Name search matches from the beginning of the entity name (starts-with). Use
shorter prefixes for broader results. Dashes are stripped before matching, so
searching
000-358-845 and 000358845 return the same result.Quirks & Gotchas
| Quirk | Details |
|---|---|
| 6-digit legacy IDs | Entities registered before ~2024 have 6-digit IDs displayed as 000NNNNNN on the portal. Both NNNNNN and 000NNNNNN are accepted as queries. |
| Dashes in Entity IDs | The portal displays IDs as 000-358-845 but the API returns and accepts undashed form 000358845. |
| LLCs have no member/manager data | Alabama law does not require LLCs to publicly disclose their members or managers. LLC lookups return zero legalRepresentatives for members and managers. Only Corporations list Directors and Incorporators. |
| Incorporators are historical | Incorporators listed on the entity detail page reflect who signed the formation documents. They do not represent current governance and are returned as legalRepresentatives without a standardized role. |
| Address format varies | Older entities (pre-2000) often have only a city and state with no street address. addressLine1 may be absent for historical records. |
| Non-entity statuses | The portal lists Name Reservations, Registered Names, and Previous Names alongside active entities. These are filtered out and return a 404. |
| Place of Formation | Foreign entities include a placeOfFormation county or US state. Domestic entities list the county where incorporated. This is returned in the activityDescription field. |
Mappings
Company Status
| Portal Status | Active |
|---|---|
| Exists | Yes |
| Cancelled | No |
| Dissolved | No |
| Merged | No |
| Revoked | No |
| Withdrawn | No |
| Converted | No |
Legal Forms
51 entity types are registered by Alabama SoS, covering domestic formations under Alabama law and foreign entities registered to do business in Alabama. ISO 20275 ELF codes are assigned to the four most common domestic types; foreign variants carry no ELF code, as the code belongs to the jurisdiction of formation.Domestic Corporations
Domestic Corporations
| Legal Form | Standardized | ISO 20275 |
|---|---|---|
| Domestic Corporation | Corporation | C3JQ |
| Domestic Benefit Corporation | Corporation | - |
| Domestic Professional Corporation | Corporation | - |
| Domestic Public Corporation | Corporation | - |
| Domestic Employee Cooperative Corporation | Corporation | - |
| Domestic Corporation Sole | Corporation | - |
Domestic Non-Profits & Associations
Domestic Non-Profits & Associations
| Legal Form | Standardized | ISO 20275 |
|---|---|---|
| Domestic Non-Profit Corporation | NonprofitOrganization | 4RCO |
| Domestic Professional Non-Profit Corporation | NonprofitOrganization | - |
| Domestic Homeowners Association | NonprofitOrganization | - |
| Domestic Professional Association | NonprofitOrganization | - |
| Domestic Non-Profit General Partnership | Partnership | - |
Domestic LLCs
Domestic LLCs
| Legal Form | Standardized | ISO 20275 |
|---|---|---|
| Domestic Limited Liability Company | LimitedLiabilityCompany | JY0X |
| Domestic Professional Limited Liability Company | LimitedLiabilityCompany | - |
| Domestic Series Limited Liability Company | LimitedLiabilityCompany | - |
| Domestic Non-Profit Ltd. Liability Company | LimitedLiabilityCompany | - |
| Domestic Non-Profit Series Ltd. Liability Company | LimitedLiabilityCompany | - |
| Domestic Professional Non-Profit Ltd. Liability Company | LimitedLiabilityCompany | - |
| Domestic Professional Series Ltd. Liability Company | LimitedLiabilityCompany | - |
Domestic Partnerships
Domestic Partnerships
| Legal Form | Standardized | ISO 20275 |
|---|---|---|
| Domestic Limited Partnership | LimitedPartnership | T91T |
| Domestic General Partnership | Partnership | - |
| Domestic Limited Liability Partnership | LimitedLiabilityPartnership | - |
| Domestic Registered Limited Liability Partnership | LimitedLiabilityPartnership | - |
| Domestic Ltd. Liability Ltd. Partnership | LimitedLiabilityPartnership | - |
Domestic Other
Domestic Other
| Legal Form | Standardized |
|---|---|
| Domestic Real Estate Investment Trust | Other |
| Domestic Unincorporated Association | Other |
| Delaware Statutory Trust | Other |
Foreign Entities
Foreign Entities
Foreign entities are registered to do business in Alabama after formation elsewhere. No ISO 20275 codes are assigned; the code belongs to the jurisdiction of formation.
| Legal Form | Standardized |
|---|---|
| Foreign Corporation | Corporation |
| Foreign Benefit Corporation | Corporation |
| Foreign Professional Corporation | Corporation |
| Foreign Public Corporation | Corporation |
| Foreign Employee Cooperative Corporation | Corporation |
| Foreign Insurance Corporation | Corporation |
| Foreign Business Entity | Other |
| Foreign Non-Profit Corporation | NonprofitOrganization |
| Foreign Professional Non-Profit Corporation | NonprofitOrganization |
| Foreign Homeowners Association | NonprofitOrganization |
| Foreign Professional Association | NonprofitOrganization |
| Foreign Limited Liability Company | LimitedLiabilityCompany |
| Foreign Professional Limited Liability Company | LimitedLiabilityCompany |
| Foreign Series Limited Liability Company | LimitedLiabilityCompany |
| Foreign Non-Profit Ltd. Liability Company | LimitedLiabilityCompany |
| Foreign Non-Profit Series Ltd. Liability Company | LimitedLiabilityCompany |
| Foreign Professional Series Ltd. Liability Company | LimitedLiabilityCompany |
| Foreign Limited Partnership | LimitedPartnership |
| Foreign General Partnership | Partnership |
| Foreign Non-Profit General Partnership | Partnership |
| Foreign Limited Liability Partnership | LimitedLiabilityPartnership |
| Foreign Registered Limited Liability Partnership | LimitedLiabilityPartnership |
| Foreign Ltd. Liability Ltd. Partnership | LimitedLiabilityPartnership |
| Foreign Real Estate Investment Trust | Other |
| Foreign Unincorporated Association | Other |
Legal Representatives
Legal representatives are returned for corporations only. Alabama LLCs are not required to publicly disclose their members or managers on the register.| Portal Role | Standardized Role | Notes |
|---|---|---|
| Director | Director | Current governance role for corporations |
| Manager | Manager | For manager-managed LLCs (rarely disclosed) |
| Member | Owner | For member-managed LLCs (rarely disclosed) |
| Incorporator | (AI-inferred) | Historical role from formation documents only |
Other Key Persons
| Portal Role | Standardized Role |
|---|---|
| Registered Agent | Registered Agent |
Data Availability
| Datapoint | Available | Notes |
|---|---|---|
| Legal name | Yes | |
| Entity ID | Yes | |
| Legal form | Yes | 51 types, standardized + ISO 20275 where applicable |
| Status | Yes | Active/inactive, AI-enriched for unknown values |
| Formation date | Yes | |
| Registration address | Yes | May be city-only for pre-2000 entities |
| Nature of business | Yes | Free-text field, returned in activityDescription |
| Directors / Incorporators | Yes | Corporations only |
| Registered agent | Yes | Name and address |
| Shareholders | No | Not collected by the Alabama register |
| Officers (President, Secretary, etc.) | No | Not published on the public portal |
| Ultimate beneficial owners | No | No state UBO register |
| Activity codes (NAICS/SIC) | No | Free-text “Nature of Business” only |
Documents
| Document | Available | Notes |
|---|---|---|
| Trade Register Extract | Yes | Printable PDF of the ARC-SOS entity detail page, included with all company data requests |
| Filing copies (Articles, Amendments, etc.) | No | Available from the Alabama SoS document portal but requires a US-issued payment card |
Example API Responses
Active domestic corporation
Active domestic corporation
Inactive (Cancelled) foreign LLC
Inactive (Cancelled) foreign LLC
Active non-profit corporation
Active non-profit corporation
Available documents
Available documents