Skip to main content
This guide is outdated and will be removed on 1 November 2026. The up-to-date Iowa reference is on the Iowa country page.

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.

Iowa coverage, pricing, and sources

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

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 monthly snapshot published at data.iowa.gov. Covers approximately 339,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 prefill 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 monthly open-data extract. The Trade Register Extract (a printed PDF of the SoS entity summary page) is bundled with this tier at no extra charge.
Mode-based routing. Prefill requests (mode: "prefill") are served from the monthly 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 monthly Iowa SoS open-data dataset covers only active entities (~339k of approximately 600k total). Entities that have dissolved, terminated, merged, or withdrawn are removed from the feed rather than tagged. They are invisible in prefill mode and only resolvable through verification mode.

Company Identifiers

Query Identifiers

The canonical Iowa Business Entity Number is 6 digits with leading zeros. Shorter numeric input (e.g. 84726) is zero-padded automatically to 084726. Input that is not numeric or is longer than 6 digits is rejected.

Identifiers in API Response

GLEIF is the supplementary data source for this identifier. company.identifiers.lei is returned when a company identifier has a unique match against this jurisdiction’s registration or validation references in GLEIF. An LEI (Legal Entity Identifier) has 20 uppercase letters and digits, ending in two check digits. Coverage varies by entity. The field is omitted when no unambiguous match is available. Lapsed or retired LEIs may be returned; annulled records are excluded.

Search Capabilities

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.

Active companies only

Search can return companies that are no longer active. Each result carries the register’s status, so activeOnly=true removes the inactive ones.

Quirks & Gotchas

Mappings

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.

Person Roles

Known titles have fixed English and standardized meanings. A combined title such as President / Director retains the officer meaning and the register’s director flag. Office-only directors are other key persons with standardized Board Member. Ordinary members and incorporators are other key persons with standardized Other. Membership alone gives no agency power, and officer functions depend on bylaws or board directions. No sole or joint signing mode is inferred.

Data Availability

Example API Responses

Search by Name

Search by Iowa Business Entity Number

Company Profile (prefill, fast, active entities)

Company Profile (verification, authoritative, includes officers)