> ## 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.
# Iowa
> Country-specific identifiers, data sources, and integration details
## Start here
This guide contains public integration notes for Iowa. Use it for identifier formats, search behavior, and state-specific caveats. The live source of truth for coverage, pricing, data sources, documents, legal forms, roles, 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)
* [Legal Forms](#legal-forms)
* [Data Availability](#data-availability)
**API access:** `US-IA` is not yet part of the public `countryCode` enum. Contact us to enable it on your workspace. Requests sent with `countryCode: "US-IA"` will otherwise return `400` until the enum is expanded.
## Data Sources
Iowa has two complementary integrations against the **Iowa Secretary of State, Business Services Division**.
* **Active Iowa Business Entities open-data extract** (fast, non-authoritative). A weekly snapshot published at `data.iowa.gov`. Covers approximately 335,000 active domestic and foreign entities: legal name, entity type, registration date, principal-office address, and registered agent. Officers and directors are not included in this extract. Used for sub-second onboarding lookups.
* **Iowa SoS business search portal** (authoritative). A live read from the `sos.iowa.gov` public business search. Returns authoritative entity status, the full officer roster (Name, role, Director flag, and address for each officer), the verified principal-office address, and the registered agent. Covers all entities in the Iowa register, including the approximately 265,000 dissolved, terminated, or withdrawn entities that are absent from the weekly open-data extract. The [Trade Register Extract](#data-availability) (a printed PDF of the SoS entity summary page) is bundled with this tier at no extra charge.
**Mode-based routing.** Onboarding requests (`mode: "onboarding"`) are served from the weekly open-data extract (fast, no live status, no officers). Verification requests (`mode: "verification"`) read the Iowa SoS portal live for authoritative status, the full officer roster, and the Trade Register Extract. Dissolved or terminated entities are only reachable through verification mode.
**Active-only open-data extract.** The weekly Iowa SoS open-data dataset covers only active entities (\~335k of approximately 600k total). Entities that have dissolved, terminated, merged, or withdrawn are removed from the feed rather than tagged. They are invisible in onboarding mode and only resolvable through verification mode.
## Company Identifiers
### Query Identifiers
| Identifier Type | Format | Example | Notes |
| ------------------------------- | ----------------------------------------------- | -------- | -------------------------------------------------------------------- |
| **Iowa Business Entity Number** | 6 digits, numeric only, leading zeros preserved | `084726` | Assigned by the Iowa Secretary of State, Business Services Division. |
The Iowa Business Entity Number is always exactly 6 digits with leading zeros preserved. Queries using the unpadded form (e.g. `84726` instead of `084726`) are rejected. The register and our API treat them as different keys.
### Identifiers in API Response
| Identifier | Format | Example | Found In |
| ------------ | --------------------- | -------- | ------------ |
| `corpNumber` | 6 digits, zero-padded | `084726` | All entities |
## Search Capabilities
| Search Type | Pattern | Example | Match Type | Expected Results |
| ------------------------------ | ----------- | ---------- | ------------------------------ | -------------------------------------------- |
| By Name | 2–100 chars | `"Hy-Vee"` | Starts-with (case-insensitive) | Multiple results, capped at 50 |
| By Iowa Business Entity Number | 6 digits | `019862` | Exact | Exact match returned first (`matchType: id`) |
**Name search anchors on the beginning of the legal name.** Use fuller query strings to narrow the result set. Inactive entities are not present in the open-data index and are surfaced through the live portal fallback. For complete coverage by name (including dissolved entities), use verification mode.
## Quirks & Gotchas
| Quirk | Details |
| ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Leading zeros are load-bearing** | Iowa Business Entity Numbers are always 6 digits with leading zeros preserved. `084726` and `84726` are treated as different keys. Never strip leading zeros. |
| **Onboarding mode returns no officers** | The weekly open-data extract does not include officer or director information. Officers, Director flags, and per-officer addresses are available only in verification mode via the live SoS portal. |
| **Active-only extract misses \~265k entities** | The open-data dataset is an active-only snapshot. Dissolved, terminated, merged, and withdrawn entities are excluded. Verification mode is the only path to reach them. |
| **No shareholder or UBO register** | Iowa does not publish shareholders or beneficial owners for any entity type. The SoS portal has no shareholder or UBO section. |
| **No activity codes** | Industry classification codes (NAICS, NACE, ISIC) are not collected by the Iowa Business Services Division. |
| **"Doing business as" names are county-level** | DBA filings in Iowa are recorded at the county recorder level and are not aggregated in the state-level open-data dataset. Fictitious names filed with the Secretary of State appear on the live portal but are not returned as a separate datapoint. |
| **Officer Director flag** | The live SoS portal includes a separate Director (Yes/No) column on each officer record. This flag is preserved on each legal representative in the API response. |
## Mappings
### Legal Forms
Iowa legal form is sourced from the corporation type published in the Iowa Secretary of State open-data dataset and the live portal. The vocabulary is a closed set of 32 values drawn from the Iowa Code, covering entity types across Title XII (Business Entities) and associated chapters. Each value is mapped to a standardized Topograph category and, where available, an ISO 20275 ELF code.
The full searchable table of all 32 Iowa legal forms with standardized mappings and ISO 20275 codes is available on the [Iowa pricing page](https://topograph.co/pricing/us-ia).
| Iowa Corporation Type | Standardized | ISO 20275 |
| ------------------------------------------------ | ----------------------- | --------- |
| Domestic Limited Liability Company | LimitedLiabilityCompany | `2HBR` |
| Foreign Limited Liability Company | LimitedLiabilityCompany | |
| Domestic For-Profit Corporation | Corporation | |
| Foreign For-Profit Corporation | Corporation | |
| Revised Domestic Nonprofit Corporation (Ch. 504) | NonprofitOrganization | |
| Revised Foreign Nonprofit Corporation (Ch. 504) | NonprofitOrganization | |
| Domestic Professional LLC | LimitedLiabilityCompany | |
| Domestic Limited Liability Partnership | Partnership | `LLP` |
| Domestic Limited Partnership | Partnership | `LPNL` |
| Domestic Cooperative | Cooperative | |
| Iowa Corporation Type | Standardized |
| ---------------------------------------------------- | ----------------------- |
| Foreign Professional LLC | LimitedLiabilityCompany |
| Domestic Professional Corporation | Corporation |
| Foreign Professional Corporation | Corporation |
| Farm Corporation (non-registered) | Corporation |
| Revised Uniform Unincorporated Nonprofit Association | NonprofitOrganization |
| General Partnership | Partnership |
| Foreign Limited Liability Partnership | Partnership |
| Foreign Limited Partnership | Partnership |
| Domestic Limited Liability Limited Partnership | Partnership |
| Foreign Limited Liability Limited Partnership | Partnership |
| County General Partnership | Partnership |
| Cooperative Association, Non-Stock (Ch. 498) | Cooperative |
| Cooperative Association, Capital Stock (Ch. 497) | Cooperative |
| Cooperative Association, Value-Added | Cooperative |
| Cooperative Association, Non-Profit | Cooperative |
| Foreign Cooperative | Cooperative |
| Multiple Housing Cooperative (Ch. 499A) | Cooperative |
| Domestic Bank (Ch. 524) | Other |
| Domestic Savings & Loan Association (Ch. 534) | Other |
| Insurance Company (Ch. 508-515) | Other |
| County and City Authority | GovernmentOwnedEntity |
| Federal Filing (not under Iowa chapter) | Other |
## Data Availability
| Data Point | Available | Notes |
| ---------------------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| Company name | Yes | Current legal name |
| Company status | Verification only | Active / Inactive / dissolution category, read live from the SoS portal. Onboarding mode (open-data extract) covers active entities only. |
| Registration date | Yes | Iowa SoS initial filing date |
| Legal address | Yes | Principal-office address (street, city, state, ZIP) |
| Legal form | Yes | Closed 32-value Iowa Code vocabulary with ISO 20275 mapping where available |
| Legal representatives | Verification only | Full officer roster (Name, role, Director flag, address) read live from the SoS portal. Not in the onboarding open-data extract. |
| Registered agent | Yes | Included in both the onboarding extract and verification mode |
| Trade Register Extract | Verification only | Printed PDF of the Iowa SoS entity summary page, bundled with the verification profile at no extra charge |
| Activity codes | No | Not collected by the Iowa Business Services Division |
| Shareholders | No | Not published |
| UBOs | No | No state-level beneficial ownership register |
| Financial data | No | Not collected |
| DBA / fictitious names | No | Filed at county recorder level; not in the state open-data dataset |
## Example API Responses
### Search by Name
```bash theme={null}
curl -X POST "https://api.topograph.co/v2/search?country=US-IA&query=Acme+Industries" \
-H "x-api-key: YOUR_API_KEY"
```
```json theme={null}
[
{
"id": "084726",
"legalName": "ACME INDUSTRIES LLC",
"countryCode": "US-IA",
"matchReason": {
"matchType": "default"
},
"address": {
"region": "IA",
"countryCode": "US"
}
}
]
```
### Search by Iowa Business Entity Number
```bash theme={null}
curl -X POST "https://api.topograph.co/v2/search?country=US-IA&query=084726" \
-H "x-api-key: YOUR_API_KEY"
```
```json theme={null}
[
{
"id": "084726",
"legalName": "ACME INDUSTRIES LLC",
"countryCode": "US-IA",
"matchReason": {
"matchType": "id"
}
}
]
```
### Company Profile (onboarding, fast, active entities)
```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-IA", "id": "084726", "dataPoints": ["company"], "mode": "onboarding"}'
```
```json theme={null}
{
"company": {
"id": "084726",
"countryCode": "US-IA",
"identifiers": { "corpNumber": "084726" },
"legalName": "ACME INDUSTRIES LLC",
"registrationDate": "2005-03-15",
"legalForm": {
"localName": "Domestic Limited Liability Company",
"standardized": "LimitedLiabilityCompany"
},
"legalAddress": {
"street": "123 Main Street",
"city": "Des Moines",
"region": "IA",
"postalCode": "50309",
"countryCode": "US"
}
}
}
```
### Company Profile (verification, authoritative, includes officers)
```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-IA", "id": "084726", "dataPoints": ["company", "legalRepresentatives"], "mode": "verification"}'
```
```json theme={null}
{
"company": {
"id": "084726",
"countryCode": "US-IA",
"identifiers": { "corpNumber": "084726" },
"legalName": "ACME INDUSTRIES LLC",
"registrationDate": "2005-03-15",
"status": {
"localName": "Active",
"active": true
},
"legalForm": {
"localName": "Domestic Limited Liability Company",
"standardized": "LimitedLiabilityCompany"
},
"legalAddress": {
"street": "123 Main Street",
"city": "Des Moines",
"region": "IA",
"postalCode": "50309",
"countryCode": "US"
}
},
"legalRepresentatives": [
{
"firstName": "Jane",
"lastName": "Smith",
"role": {
"localName": "President / Director",
"standardized": "President"
}
}
]
}
```