Skip to main content

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

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 TypeFormatExampleNotes
Entity ID Number9-digit zero-padded integer. Accepted with or without dashes (000-358-845 or 000358845). Legacy 6-digit IDs (pre-2024) are accepted without padding.000358845Primary identifier assigned by Alabama SoS at registration
Alabama migrated from 6-digit to 9-digit Entity IDs around 2024 by prepending three leading zeros. Both formats are accepted: 358845 and 000358845 resolve to the same entity.

Identifiers in API Response

IdentifierFormatExampleFound In
entityIdNNNNNNNNN000358845All entities

Search Capabilities

Search TypePatternExampleMatch TypeExpected Results
By Name2–200 chars"Alabama Holdings"Starts withMultiple results
By Entity ID1–9 digits000358845ExactSingle 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

QuirkDetails
6-digit legacy IDsEntities registered before ~2024 have 6-digit IDs displayed as 000NNNNNN on the portal. Both NNNNNN and 000NNNNNN are accepted as queries.
Dashes in Entity IDsThe portal displays IDs as 000-358-845 but the API returns and accepts undashed form 000358845.
LLCs have no member/manager dataAlabama 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 historicalIncorporators 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 variesOlder entities (pre-2000) often have only a city and state with no street address. addressLine1 may be absent for historical records.
Non-entity statusesThe portal lists Name Reservations, Registered Names, and Previous Names alongside active entities. These are filtered out and return a 404.
Place of FormationForeign 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 StatusActive
ExistsYes
CancelledNo
DissolvedNo
MergedNo
RevokedNo
WithdrawnNo
ConvertedNo
Unknown statuses not in the table above are resolved via AI enrichment. 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.
Legal FormStandardizedISO 20275
Domestic CorporationCorporationC3JQ
Domestic Benefit CorporationCorporation-
Domestic Professional CorporationCorporation-
Domestic Public CorporationCorporation-
Domestic Employee Cooperative CorporationCorporation-
Domestic Corporation SoleCorporation-
Legal FormStandardizedISO 20275
Domestic Non-Profit CorporationNonprofitOrganization4RCO
Domestic Professional Non-Profit CorporationNonprofitOrganization-
Domestic Homeowners AssociationNonprofitOrganization-
Domestic Professional AssociationNonprofitOrganization-
Domestic Non-Profit General PartnershipPartnership-
Legal FormStandardizedISO 20275
Domestic Limited Liability CompanyLimitedLiabilityCompanyJY0X
Domestic Professional Limited Liability CompanyLimitedLiabilityCompany-
Domestic Series Limited Liability CompanyLimitedLiabilityCompany-
Domestic Non-Profit Ltd. Liability CompanyLimitedLiabilityCompany-
Domestic Non-Profit Series Ltd. Liability CompanyLimitedLiabilityCompany-
Domestic Professional Non-Profit Ltd. Liability CompanyLimitedLiabilityCompany-
Domestic Professional Series Ltd. Liability CompanyLimitedLiabilityCompany-
Legal FormStandardizedISO 20275
Domestic Limited PartnershipLimitedPartnershipT91T
Domestic General PartnershipPartnership-
Domestic Limited Liability PartnershipLimitedLiabilityPartnership-
Domestic Registered Limited Liability PartnershipLimitedLiabilityPartnership-
Domestic Ltd. Liability Ltd. PartnershipLimitedLiabilityPartnership-
Legal FormStandardized
Domestic Real Estate Investment TrustOther
Domestic Unincorporated AssociationOther
Delaware Statutory TrustOther
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 FormStandardized
Foreign CorporationCorporation
Foreign Benefit CorporationCorporation
Foreign Professional CorporationCorporation
Foreign Public CorporationCorporation
Foreign Employee Cooperative CorporationCorporation
Foreign Insurance CorporationCorporation
Foreign Business EntityOther
Foreign Non-Profit CorporationNonprofitOrganization
Foreign Professional Non-Profit CorporationNonprofitOrganization
Foreign Homeowners AssociationNonprofitOrganization
Foreign Professional AssociationNonprofitOrganization
Foreign Limited Liability CompanyLimitedLiabilityCompany
Foreign Professional Limited Liability CompanyLimitedLiabilityCompany
Foreign Series Limited Liability CompanyLimitedLiabilityCompany
Foreign Non-Profit Ltd. Liability CompanyLimitedLiabilityCompany
Foreign Non-Profit Series Ltd. Liability CompanyLimitedLiabilityCompany
Foreign Professional Series Ltd. Liability CompanyLimitedLiabilityCompany
Foreign Limited PartnershipLimitedPartnership
Foreign General PartnershipPartnership
Foreign Non-Profit General PartnershipPartnership
Foreign Limited Liability PartnershipLimitedLiabilityPartnership
Foreign Registered Limited Liability PartnershipLimitedLiabilityPartnership
Foreign Ltd. Liability Ltd. PartnershipLimitedLiabilityPartnership
Foreign Real Estate Investment TrustOther
Foreign Unincorporated AssociationOther
Legal representatives are returned for corporations only. Alabama LLCs are not required to publicly disclose their members or managers on the register.
Portal RoleStandardized RoleNotes
DirectorDirectorCurrent governance role for corporations
ManagerManagerFor manager-managed LLCs (rarely disclosed)
MemberOwnerFor member-managed LLCs (rarely disclosed)
Incorporator(AI-inferred)Historical role from formation documents only

Other Key Persons

Portal RoleStandardized Role
Registered AgentRegistered Agent

Data Availability

DatapointAvailableNotes
Legal nameYes
Entity IDYes
Legal formYes51 types, standardized + ISO 20275 where applicable
StatusYesActive/inactive, AI-enriched for unknown values
Formation dateYes
Registration addressYesMay be city-only for pre-2000 entities
Nature of businessYesFree-text field, returned in activityDescription
Directors / IncorporatorsYesCorporations only
Registered agentYesName and address
ShareholdersNoNot collected by the Alabama register
Officers (President, Secretary, etc.)NoNot published on the public portal
Ultimate beneficial ownersNoNo state UBO register
Activity codes (NAICS/SIC)NoFree-text “Nature of Business” only

Documents

DocumentAvailableNotes
Trade Register ExtractYesPrintable PDF of the ARC-SOS entity detail page, included with all company data requests
Filing copies (Articles, Amendments, etc.)NoAvailable from the Alabama SoS document portal but requires a US-issued payment card

Example API Responses

{
  "company": {
    "id": "000120714",
    "countryCode": "US-AL",
    "legalName": "SAMPLE MANUFACTURING INCORPORATED",
    "legalForm": {
      "localName": "Domestic Corporation",
      "standardized": "Corporation",
      "iso20275Code": "C3JQ"
    },
    "status": { "active": true, "localName": "Exists" },
    "legalAddress": {
      "addressLine1": "100 COMMERCE DRIVE SUITE 200",
      "city": "BIRMINGHAM",
      "region": "AL",
      "postalCode": "35203",
      "countryCode": "US"
    },
    "registrationDate": "1987-11-23",
    "activityDescription": "MANUFACTURING"
  },
  "legalRepresentatives": [
    {
      "type": "INDIVIDUAL",
      "role": { "localName": "Director", "standardized": "Director" },
      "individual": {
        "name": { "fullName": "SMITH JOHN A" },
        "residenceAddress": {
          "addressLine1": "100 COMMERCE DRIVE",
          "city": "BIRMINGHAM",
          "region": "AL",
          "postalCode": "35203",
          "countryCode": "US"
        }
      }
    },
    {
      "type": "INDIVIDUAL",
      "role": { "localName": "Incorporator", "standardized": "Other" },
      "individual": { "name": { "fullName": "DOE JANE B" } }
    }
  ],
  "otherKeyPersons": [
    {
      "type": "INDIVIDUAL",
      "role": { "localName": "Registered Agent", "standardized": "RegisteredAgent" },
      "individual": {
        "name": { "fullName": "REGISTERED AGENTS OF ALABAMA LLC" },
        "residenceAddress": {
          "addressLine1": "2 NORTH JACKSON STREET SUITE 605",
          "city": "MONTGOMERY",
          "region": "AL",
          "postalCode": "36104",
          "countryCode": "US"
        }
      }
    }
  ]
}
{
  "company": {
    "id": "000605255",
    "countryCode": "US-AL",
    "legalName": "SAMPLE TECHNOLOGY LLC",
    "legalForm": {
      "localName": "Foreign Limited Liability Company",
      "standardized": "LimitedLiabilityCompany"
    },
    "status": { "active": false, "localName": "Cancelled" },
    "legalAddress": {
      "city": "HUNTSVILLE",
      "region": "AL",
      "countryCode": "US"
    },
    "registrationDate": "2010-03-15"
  },
  "legalRepresentatives": [],
  "otherKeyPersons": [
    {
      "type": "INDIVIDUAL",
      "role": { "localName": "Registered Agent", "standardized": "RegisteredAgent" },
      "individual": { "name": { "fullName": "JONES ROBERT C" } }
    }
  ]
}
{
  "company": {
    "id": "001169235",
    "countryCode": "US-AL",
    "legalName": "SAMPLE COMMUNITY FOUNDATION",
    "legalForm": {
      "localName": "Domestic Non-Profit Corporation",
      "standardized": "NonprofitOrganization",
      "iso20275Code": "4RCO"
    },
    "status": { "active": true, "localName": "Exists" },
    "legalAddress": {
      "addressLine1": "500 WHITESBURG DRIVE",
      "city": "HUNTSVILLE",
      "region": "AL",
      "postalCode": "35801",
      "countryCode": "US"
    },
    "registrationDate": "2015-06-10",
    "activityDescription": "COMMUNITY DEVELOPMENT"
  },
  "legalRepresentatives": [
    {
      "type": "INDIVIDUAL",
      "role": { "localName": "Director", "standardized": "Director" },
      "individual": { "name": { "fullName": "WILLIAMS SARAH K" } }
    }
  ],
  "otherKeyPersons": [
    {
      "type": "INDIVIDUAL",
      "role": { "localName": "Registered Agent", "standardized": "RegisteredAgent" },
      "individual": {
        "name": { "fullName": "SAMPLE REGISTERED AGENTS INC" },
        "residenceAddress": {
          "addressLine1": "300 CORPORATE DRIVE",
          "city": "BIRMINGHAM",
          "region": "AL",
          "postalCode": "35242",
          "countryCode": "US"
        }
      }
    }
  ]
}
{
  "documents": {
    "tradeRegisterExtract": {
      "id": "c710ff36-6a0b-55bf-a957-43a6a7f2240d",
      "name": "Trade Register Extract",
      "description": "Printable extract of the Alabama Secretary of State ARC-SOS Entity Detail page. Includes Entity ID Number, legal name, entity type, status, formation date, registered agent, principal address, nature of business, capital information, and filing history.",
      "format": "pdf"
    }
  }
}