> ## 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.
# South Dakota
> Country-specific identifiers, data sources, and integration details
## Start here
This guide contains public integration notes for South Dakota. Use it for identifier formats, search behavior, and state-specific caveats. The live source of truth for coverage, pricing, data sources, documents, legal forms, and status values is the pricing page.
Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
This jurisdiction may be in preview or limited availability. Check the live pricing page or contact support before relying on it in production.
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.
## Table of Contents
* [Data Sources](#data-sources)
* [Company Identifiers](#company-identifiers)
* [Search Capabilities](#search-capabilities)
* [Quirks & Gotchas](#quirks--gotchas)
* [Mappings](#mappings)
* [Company Status](#company-status)
* [Data Availability](#data-availability)
**API access:** `US-SD` is not yet part of the public `countryCode` enum. Contact us to enable it on your workspace. Requests sent with `countryCode: "US-SD"` will otherwise return `400` until the enum is expanded.
## Data Sources
South Dakota uses a single live integration against the **South Dakota Secretary of State SoS Enterprise portal** (`sosenterprise.sd.gov`). Every request hits the register in real time. There is no open-data feed or bulk extract available for free: the register only offers a paid paper subscription for bulk database downloads, so Topograph sources data directly from the live portal.
The register covers every domestic and foreign for-profit and nonprofit corporation, LLC, limited partnership, registered limited liability partnership, financial institution (bank, trust company), and trade name filed in South Dakota.
**Two retrieval modes, same price.** Set the `mode` parameter:
* **`onboarding`** — a fast base profile: legal name, entity type, current status, and filing/registration date. Non-authoritative (`authoritative: false` in the response); it does **not** include the address or registered agent.
* **`verification`** (default) — the full authoritative record: adds the principal office address, the registered agent (`otherKeyPersons`), and the bundled Trade Register Extract.
Both modes bill identically and resolve live against the register (there is no free bulk-data snapshot). Use `onboarding` for a fast identity/status check and `verification` for the complete record.
## Company Identifiers
### Query Identifiers
| Identifier Type | Format | Example | Notes |
| --------------- | --------------------------------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------- |
| **Business ID** | Two-letter prefix + six zero-padded digits (8 characters total) | `FB033693` | Assigned by the South Dakota Secretary of State. The prefix encodes the filing class (see table below). |
**Common Business ID prefixes:**
| Prefix | Filing Class |
| ------ | -------------------------------- |
| `DM` | Domestic corporation |
| `DC` | Domestic corporation (alternate) |
| `DL` | Domestic LLC |
| `FL` | Foreign LLC |
| `FB` | Foreign for-profit corporation |
| `NP` | Nonprofit corporation |
| `BK` | Bank / financial institution |
| `TN` | Trade name |
The Business ID is exactly 8 characters. The two-letter prefix is always uppercase and the six-digit suffix is zero-padded. Both the prefix and the padding are significant. Do not strip or alter them when passing the ID to the API.
### Identifiers in API Response
| Identifier | Format | Example | Found In |
| ------------ | ------------------------------------------ | ---------- | ------------ |
| `businessId` | Two-letter prefix + six zero-padded digits | `FB033693` | All entities |
## Search Capabilities
| Search Type | Pattern | Example | Match Type | Expected Results |
| -------------- | ------------ | ---------- | ------------------------------ | ---------------------------------------------------------------------- |
| By Name | 2–100 chars | `"Acme"` | Starts-with (case-insensitive) | Multiple results |
| By Business ID | 8 characters | `FB033693` | Exact | Exact match returned first (`matchType: id`); other results may follow |
**Starts-with search.** Name search anchors on the beginning of the legal name (case-insensitive). Use more specific queries to narrow the result set, which is capped at 50 matches.
## Quirks & Gotchas
| Quirk | Details |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Prefix is not optional** | The two-letter prefix is part of the Business ID. Passing only the numeric portion (e.g. `033693`) is not a valid identifier and will return no results. |
| **No officers or directors** | The South Dakota register does not publish officers, directors, members, or organizers on any entity detail page. The only party disclosed publicly is the registered agent, which is returned under `otherKeyPersons`. |
| **Registered agent is not a legal representative** | The registered agent receives service of process but has no statutory authority to bind the entity. It appears under `otherKeyPersons`, not `legalRepresentatives`. |
| **No shareholder list** | South Dakota does not publish individual shareholders or owner lists for any entity type. For-profit corporations carry an authorized capital figure (share count and par value) on the register record, but it is not currently surfaced in the response, and no shareholder register exists. |
| **No activity codes** | NAICS, NACE, and ISIC codes are not collected by the South Dakota business register. |
| **Addresses are parsed** | The register records the principal office address in a compact form; Topograph parses it into structured `legalAddress` fields (and geocodes it) in verification mode. |
| **Foreign name field** | Foreign entities may carry a separate foreign-registered name on the register record. It is not currently surfaced in the API response. |
| **Term of duration** | Most entities are "Perpetual"; some carry a fixed expiration date. This is on the register record but is not currently surfaced in the API response. |
| **No open-data snapshot** | Unlike many US states, South Dakota does not publish a free bulk dataset. Every request goes to the live register portal. |
## Mappings
### Company Status
Status is read directly from the register and mapped to a Topograph standardized value.
| Register Status | Standardized | Notes |
| ------------------------ | ------------ | ------------------------------------------------- |
| Good Standing | Active | All annual reports current |
| Active | Active | Used on financial-institution filings |
| Revoked (Administrative) | Closed | Annual-report lapse; administrative dissolution |
| Dissolved | Closed | Voluntary dissolution |
| Withdrawn | Closed | Foreign entity withdrew South Dakota registration |
| Merged | Closed | Entity merged into another |
| Expired | Closed | Term of duration expired |
Status values not in the table above are surfaced as-is from the register under `company.status.localName` and may be enriched by AI where the raw label maps to a known standardized category.
## Data Availability
**Onboarding mode** returns only the base fields — company name, entity type / legal form, current status, and registration date. The principal office address, the registered agent, and the Trade Register Extract require **verification mode**.
| Data Point | Available | Notes |
| ------------------------- | --------- | -------------------------------------------------------------------------------------------------- |
| Company name | Yes | Current legal name (both modes) |
| Company status | Yes | Current status, e.g. Good Standing / Withdrawn / Revoked (both modes) |
| Legal form | Yes | Entity type as recorded by the register, e.g. `CORP`, `LLC` (both modes) |
| Registration date | Yes | Filing date with the Secretary of State (both modes) |
| Legal address | Yes | Principal office address, parsed and geocoded — **verification mode only** |
| Registered agent | Yes | Name and address, returned as `otherKeyPersons` — **verification mode only** |
| Former legal names | Yes | Prior legal names of renamed entities, returned as `legacyLegalNames` — **verification mode only** |
| Trade Register Extract | Yes | Printed PDF of the entity record, bundled at no extra charge — **verification mode only** |
| Foreign registered name | No | Present on the register record but not currently surfaced in the response |
| Mailing address | No | Present on the register record but not currently surfaced in the response |
| Jurisdiction of formation | No | Present on the register record but not currently surfaced in the response |
| Term of duration | No | Present on the register record but not currently surfaced in the response |
| Annual report due date | No | Present on the register record but not currently surfaced in the response |
| Legal representatives | No | Officers, directors, and members are not published by the South Dakota register |
| Activity codes | No | Not collected by the register |
| Shareholders | No | Not published for any entity type |
| UBOs | No | No state beneficial-ownership register; the federal database is restricted |
| Annual report PDFs | Roadmap | Referenced in the entity filing history but not yet available as downloadable documents |
| Articles of Incorporation | Roadmap | Per-filing PDFs are deferred |
| Financial data | No | Not collected by the South Dakota register |
## Example API Responses
### Search by Name
```bash theme={null}
curl -X POST "https://api.topograph.co/v2/search?country=US-SD&query=Smithfield%20Packaged" \
-H "x-api-key: YOUR_API_KEY"
```
```json theme={null}
[
{
"id": "FB033693",
"legalName": "SMITHFIELD PACKAGED MEATS CORP.",
"countryCode": "US-SD",
"matchReason": { "matchType": "default" },
"address": { "countryCode": "US-SD" }
},
{
"id": "FB038869",
"legalName": "SMITHFIELD PACKAGED MEATS SALES CORP.",
"countryCode": "US-SD",
"matchReason": { "matchType": "default" },
"address": { "countryCode": "US-SD" }
}
]
```
### Search by Business ID
```bash theme={null}
curl -X POST "https://api.topograph.co/v2/search?country=US-SD&query=BK000183" \
-H "x-api-key: YOUR_API_KEY"
```
```json theme={null}
[
{
"id": "BK000183",
"legalName": "FIRST PREMIER BANK",
"countryCode": "US-SD",
"matchReason": { "matchType": "id" },
"address": { "countryCode": "US-SD" }
}
]
```
### Company Profile — onboarding mode (fast base 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-SD", "id": "FB196942", "dataPoints": ["company"], "mode": "onboarding"}'
```
```json theme={null}
{
"company": {
"id": "FB196942",
"countryCode": "US-SD",
"identifiers": { "businessId": "FB196942" },
"legalName": "Smithfield Foods, Inc.",
"registrationDate": "2021-02-18",
"status": { "localName": "Good Standing", "active": true, "statusDetails": { "status": "ACTIVE" } },
"legalForm": { "localName": "CORP" }
}
}
```
### Company Profile — verification mode (full record with registered agent)
```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-SD", "id": "FB033693", "dataPoints": ["company", "otherKeyPersons"], "mode": "verification"}'
```
```json theme={null}
{
"company": {
"id": "FB033693",
"countryCode": "US-SD",
"identifiers": { "businessId": "FB033693" },
"legalName": "SMITHFIELD PACKAGED MEATS CORP.",
"legacyLegalNames": ["JOHN MORRELL & CO."],
"registrationDate": "2009-08-04",
"status": { "localName": "Good Standing", "active": true, "statusDetails": { "status": "ACTIVE" } },
"legalForm": { "localName": "CORP" },
"legalAddress": {
"addressLine1": "200 Commerce Street",
"city": "Smithfield",
"postalCode": "23430",
"region": "Isle of Wight County",
"state": "Virginia",
"countryCode": "US",
"latitude": 36.98475035,
"longitude": -76.63012801121371
}
},
"otherKeyPersons": [
{
"entityId": "company_001",
"type": "company",
"role": { "localName": "Registered Agent", "standardized": "Other" },
"company": {
"countryCode": "US",
"legalName": "C T CORPORATION SYSTEM",
"legalAddress": {
"addressLine1": "319 S COTEAU ST",
"city": "PIERRE",
"postalCode": "57501-3187",
"region": "SD",
"countryCode": "US"
}
}
}
]
}
```