Iowa Secretary of State – Business Entity Data API

Quick access: https://api.sos.iowa.gov/swagger/ui/index

The Iowa Secretary of State’s office is excited to offer API access to our business entity data.

The API provides business entity data traditionally accessed through our html user interface: https://sos.iowa.gov/search/business

Access:

• Guest access is limited, available at: https://api.sos.iowa.gov/swagger/ui/index
• Subscription access is fee based. Monthly subscription $2,400.00/year, billed quarterly. Weekly subscription $10,400.00/year, billed quarterly.

Authentication:

• Subscribers are issued an authentication token.
• Securely send the token over https as basic authentication.
• Code sample is included below.

Data:

• Formatted as JSON.
• JSON Schema (business entity): https://api.sos.iowa.gov/BusinessEntity/schema
• JSON Schema (lists): https://api.sos.iowa.gov/BusinessEntity/schemaLists

Endpoints:

• Listed with response codes: https://api.sos.iowa.gov/swagger/ui/index

Definitions:

• Modified - Used to designate change to a business entity’s data. For example, the business entity files a new document, change to registered agent, change to officers, change to address, change of status, etc.
• Update - Used to designate that a business entity’s record in the API database has been changed. For example, the business entity is new and therefore added to the API database. An update may, or may not, indicate that the business entity’s data was modified.

Code Sample: API Call (C# .NET):

    string myToken = "226148a2-b3ce-482f-83a8-bdeca1403883";
    Uri requestUri = new Uri("https://api.sos.iowa.gov/businessEntity/id/19862");
    System.Net.Http.HttpClient httpClient = new System.Net.Http.HttpClient();
    string response = "";

    httpClient.DefaultRequestHeaders.Authorization =
        new System.Net.Http.Headers.AuthenticationHeaderValue("Basic", myToken);

    System.Threading.Tasks.Task.Run(async () =>
    {
        response = await httpClient.GetStringAsync(requestUri);
    }).Wait();

    Console.WriteLine(response);