> ## 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.

# Arkansas

> Country-specific identifiers, data sources, and integration details

## Start here

This guide contains public integration notes for Arkansas. Use it for identifier formats, search behavior, and country-specific caveats. The live source of truth for coverage, pricing, data sources, documents, legal forms, roles, and status values is the pricing page.

<Card title="Arkansas coverage, pricing, and sources" icon="arrow-up-right-from-square" href="https://topograph.co/pricing/us-ar">
  Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
</Card>

<Warning>
  This jurisdiction may be in preview or limited availability. Check the live pricing page or contact support before relying on it in production.
</Warning>

<Note>
  Country details below are preserved as integration notes. If a table or example conflicts with the live pricing page, use the pricing page as the source of truth and contact support.
</Note>

## Table of Contents

* [Data Sources](#data-sources)
* [Company Identifiers](#company-identifiers)
* [Search Capabilities](#search-capabilities)
* [Quirks & Gotchas](#quirks--gotchas)
* [Mappings](#mappings)
  * [Legal Forms](#legal-forms)
  * [Officer Roles](#officer-roles)
  * [Filing Status](#filing-status)
* [Data Availability](#data-availability)

<Warning>
  **API access:** `US-AR` is not yet part of the public `countryCode` enum. Contact us to enable it on your workspace. Requests sent with `countryCode: "US-AR"` will otherwise return `400` until the enum is expanded.
</Warning>

## Data Sources

Arkansas uses a single integration against the **Arkansas Secretary of State, Business & Commercial Services** portal (`sos-corp-search.ark.org`). The portal is publicly accessible and covers domestic and foreign entities filed with the SoS: corporations, limited liability companies, limited partnerships, general partnerships, and nonprofits.

The portal exposes:

* Legal name, filing number, entity type, and filing status
* Principal address and registered agent with address
* Filing date and, for foreign entities, state of origin
* Officers (when filed with the SoS)

The printable entity detail page is delivered as the **Trade Register Extract**, included at no extra charge with every company data request.

<Note>
  Arkansas data is retrieved directly from the public SoS portal on each request. There is no snapshot or bulk extract available from this register. Frequently queried entities often respond quickly due to server-side caching on the portal.
</Note>

## Company Identifiers

### Query Identifiers

| Identifier Type            | Format                                                                   | Example     | Notes                                                               |
| -------------------------- | ------------------------------------------------------------------------ | ----------- | ------------------------------------------------------------------- |
| **Arkansas Filing Number** | 8-9 digits; legacy filings begin with `100` or `800`, current with `811` | `811388512` | Assigned by the Arkansas Secretary of State at time of registration |

<Tip>
  Arkansas filing numbers are 8-9 digit numerics with no separators or leading zeros. The prefix loosely tracks registration era: `100…` and `800…` are legacy filings, `811…` is the current series for modern registrations.
</Tip>

### Identifiers in API Response

| Identifier     | Format                | Example     | Found In     |
| -------------- | --------------------- | ----------- | ------------ |
| `filingNumber` | 8-9 digits, no prefix | `811388512` | All entities |

## Search Capabilities

| Search Type      | Pattern     | Example     | Match Type                     | Expected Results                             |
| ---------------- | ----------- | ----------- | ------------------------------ | -------------------------------------------- |
| By Name          | 2-100 chars | `"Walmart"` | Starts-with (case-insensitive) | Multiple results, up to 50 returned          |
| By Filing Number | 8-9 digits  | `811388512` | Exact                          | Exact match returned first (`matchType: id`) |

<Note>
  **Result cap.** The SoS portal silently caps search results at 250 rows server-side. Topograph returns up to 50 results ranked alphabetically. For narrow queries this is invisible; for broad name queries (e.g. a single common word) expect truncation without a `truncated` flag in the response.
</Note>

## Quirks & Gotchas

| Quirk                                         | Details                                                                                                                                                                                                                                        |
| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **No identifier prefix or padding**           | Filing numbers are plain 8-9 digit integers. Do not add leading zeros or prefixes. Pass the number exactly as returned by search.                                                                                                              |
| **`Incorporator/Organizer` is a single role** | The Arkansas SoS uses one label for both LLC organizers and corporation incorporators. The distinction is not recoverable from public data.                                                                                                    |
| **Legacy "SEE FILE" officers**                | Older filings (typically `100…` series) often carry a `SEE FILE` placeholder in the officers block. This means the officer data exists on paper but is not digitized on the portal. The API returns an empty officers list for these entities. |
| **Status field: `Pending`**                   | A `Pending` status means the filing has been submitted but not finalized. The `active` field in the response is `undefined` (neither `true` nor `false`) for pending entities.                                                                 |
| **No shareholders or UBOs**                   | Arkansas does not publish shareholder lists or beneficial ownership data at the state level. Federal FinCEN BOI records are restricted.                                                                                                        |
| **No activity codes**                         | The Arkansas SoS does not collect NAICS, NACE, or ISIC codes. Industry classification is not available.                                                                                                                                        |
| **Fictitious names live separately**          | DBA-style fictitious name registrations are a separate track and are not included in the business entity search index.                                                                                                                         |
| **Certificate of Good Standing is paid**      | The Certificate of Good Standing exists but requires a separate purchase through the Arkansas state payment flow. It is not yet available through Topograph.                                                                                   |

## Mappings

### Legal Forms

Legal form is sourced from the entity-type field published by the Arkansas Secretary of State. The raw string is passed through to `legalForm.localName` and also used as input for AI-inferred standardization.

Common entity types observed:

<AccordionGroup>
  <Accordion title="Common Arkansas entity types">
    | AR SoS Entity Type                | Standardized            |
    | --------------------------------- | ----------------------- |
    | For Profit Corporation            | Corporation             |
    | Foreign For Profit Corporation    | Corporation             |
    | Non-Profit Corporation            | NonprofitOrganization   |
    | Foreign Non-Profit Corporation    | NonprofitOrganization   |
    | Limited Liability Company         | LimitedLiabilityCompany |
    | Foreign Limited Liability Company | LimitedLiabilityCompany |
    | Limited Partnership               | Partnership             |
    | Foreign Limited Partnership       | Partnership             |
    | General Partnership               | Partnership             |
    | Limited Liability Partnership     | Partnership             |
    | Professional Association          | Corporation             |
    | Bank                              | Other                   |
    | Insurance Company                 | Other                   |
  </Accordion>
</AccordionGroup>

<Note>
  The full list of entity types and their standardized mappings is on the [pricing page](https://topograph.co/pricing/us-ar). The table above lists commonly observed types; the register may publish additional variants.
</Note>

### Officer Roles

Officer role labels on the Arkansas SoS portal are free-text. Topograph normalizes them through AI enrichment to produce a standardized role and English translation.

| Raw AR Role Label      | Standardized (AI-inferred) | Notes                                                          |
| ---------------------- | -------------------------- | -------------------------------------------------------------- |
| President              | President                  |                                                                |
| Vice President         | VicePresident              | Also observed as `Vice-President`                              |
| Secretary              | Secretary                  |                                                                |
| Assistant Secretary    | Secretary                  | Also observed as `Assistant Sec.`                              |
| Treasurer              | Treasurer                  |                                                                |
| Director               | Director                   |                                                                |
| Manager                | Manager                    |                                                                |
| Member                 | Member                     | Member-managed LLCs                                            |
| Owner                  | Owner                      |                                                                |
| Incorporator/Organizer | (AI-inferred)              | Single AR label covering both LLC organizers and incorporators |
| Incorporator           | Incorporator               |                                                                |
| Organizer              | Organizer                  |                                                                |
| Registered Agent       | RegisteredAgent            | Key person; no authority to bind the entity                    |

<Note>
  Roles not listed above are still included in the response with their raw AR label as `localName`. Standardization is AI-inferred from the raw text.
</Note>

### Filing Status

| AR SoS Status     | `active` field | Notes                                                      |
| ----------------- | -------------- | ---------------------------------------------------------- |
| Good Standing     | `true`         | Entity is in good standing with the SoS                    |
| Pending           | `undefined`    | Filing submitted but not yet finalized                     |
| Dissolved         | `false`        |                                                            |
| Expired           | `false`        |                                                            |
| Forfeited Charter | `false`        | Charter revoked, typically for failure to file or pay fees |
| Converted         | `false`        | Entity converted to another form                           |
| Merged            | `false`        | Entity merged into another entity                          |

## Data Availability

| Data Point                   | Available | Notes                                                                                   |
| ---------------------------- | --------- | --------------------------------------------------------------------------------------- |
| Company name                 | Yes       | Current legal name                                                                      |
| Company status               | Yes       | `active: true/false/undefined` plus the raw SoS status string                           |
| Registration date            | Yes       | SoS initial filing date                                                                 |
| Legal address                | Yes       | Principal address as filed with the SoS                                                 |
| Legal form                   | Yes       | Raw entity type from the SoS, with AI-inferred standardization                          |
| Legal representatives        | Yes       | Officers as filed; normalized through AI role enrichment                                |
| Registered agent             | Yes       | Name and address from the SoS detail page                                               |
| State of origin              | Yes       | Two-letter US state code for foreign entities (e.g. `DE`)                               |
| Trade Register Extract       | Yes       | Printed PDF of the SoS entity detail page; included at no extra charge                  |
| Activity codes               | No        | Not collected by the Arkansas SoS                                                       |
| Shareholders                 | No        | Not published by the Arkansas SoS                                                       |
| UBOs                         | No        | No state-level beneficial ownership register; federal FinCEN BOI is restricted          |
| Certificate of Good Standing | Roadmap   | Requires a separate paid purchase through the Arkansas state portal; not yet integrated |
| Fictitious names (DBAs)      | No        | Registered under a separate track, not part of the business entity dataset              |
| Financial data               | No        | Not collected                                                                           |

## Example API Responses

### Search by Name

```bash theme={null}
curl -X POST "https://api.topograph.co/v2/search?country=US-AR&query=Acme" \
  -H "x-api-key: YOUR_API_KEY"
```

```json theme={null}
[
  {
    "id": "811388512",
    "legalName": "ACME HOLDINGS, INC.",
    "countryCode": "US-AR",
    "matchReason": {
      "matchType": "default"
    },
    "address": {
      "region": "AR",
      "countryCode": "US"
    }
  }
]
```

### Search by Filing Number

```bash theme={null}
curl -X POST "https://api.topograph.co/v2/search?country=US-AR&query=811388512" \
  -H "x-api-key: YOUR_API_KEY"
```

```json theme={null}
[
  {
    "id": "811388512",
    "legalName": "ACME HOLDINGS, INC.",
    "countryCode": "US-AR",
    "matchReason": {
      "matchType": "id"
    }
  }
]
```

### Company Profile

```bash theme={null}
curl -X POST "https://api.topograph.co/v2/company" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"countryCode": "US-AR", "id": "811388512", "dataPoints": ["company", "legalRepresentatives"]}'
```

```json theme={null}
{
  "company": {
    "id": "811388512",
    "countryCode": "US-AR",
    "identifiers": { "filingNumber": "811388512" },
    "legalName": "ACME HOLDINGS, INC.",
    "registrationDate": "2012-03-15",
    "status": {
      "localName": "Good Standing",
      "active": true
    },
    "legalForm": {
      "localName": "Foreign For Profit Corporation",
      "standardized": "Corporation"
    },
    "legalAddress": {
      "streetAddress": "123 Main Street",
      "city": "Little Rock",
      "region": "AR",
      "postalCode": "72201",
      "countryCode": "US"
    }
  },
  "legalRepresentatives": [
    {
      "fullName": "JANE A. EXAMPLE",
      "role": {
        "localName": "President",
        "englishTranslation": "President"
      }
    }
  ]
}
```
