We offer a simple API for searching and retrieving corporations data which you may use in your applications and web sites. Results can be returned in JSON with padding (JSONP) and XML formats. You do not need to apply for a special key to retrieve the information.

Getting Started

The easiest way to retrieve results is to use our web site to search for the information you need, using the parameters you plan to use in your application. On the results screen for both the results and the details of a corporation/entity, append the query string with "format=xml" or "format=json", respectively. This will give you an example of what will be returned. You can then use the final URL and modify the values as you deem necessary.

Searching

A maximum of 20 results are returned with each query.

URL: http://www.sos.wa.gov/corps/search_results.aspx

Query String Parameters:

name (required) - words or partial words to be found within a corporations name
name_type - "starts_with", "contains", or "ends_with", specifies how the values for the name parameter should function
criteria - "all", "any", "exact" , in multi-word searches, this specifies how the words can or cannot appear in a corporations name
category - category of the corporation.
    "na" - All
    "BNK" - Bank
    "COP" - Cooperative
    "SOL" - Corporation Sole
    "CRU" - Credit Union
    "FMA" - Fish Marketing Act
    "RFN" - Foreign Registration
    "FBS" - Fraternal Building Society
    "FRA" - Fraternal Society
    "GRG" - Grange
    "INS" - Insurance
    "LLP" - Limited Liability Partnership
    "PLC" - Limited Liability Professional
    "LLC" - Limited Liability Regular
    "LTD" - Limited Partnership
    "MAS" - Massachusetts Trust
    "MIL" - Military
    "MMC" - Miscellaneous and Mutual
    "PRO" - Professional Service
    "PBC" - Public Benefit Corporation
    "PUB" - Public Utilities
    "REG" - Regular Corporation
    "RES" - Reservation of Name
    "SAL" - Savings and Loan
    "CAS" - Special Cooperative
active - status of the corporation.  "A" for active, "T" for inactive, "NA" for either
agent_name - name or partial name of registered agent
city - city of registered agent's address
zip - zip of regisetered agent's address
date1 - begining date of date range for date of incorporation (format: MM-DD-YYYY)
date2 - ending date of date range for date of incorporation (format: MM-DD-YYYY)
start - number in the results set to begin the search. For example, if a query returns 1000 results, specifying a start of 80 would return results 80 through 99 in the list.
format - "json" or "xml"
callback - for json format, this value must be supplied for cross-site scripting access. Use "?" with jquery.

Examples:

JSON

http://www.sos.wa.gov/corps/search_results.aspx?name_type=starts_with&name=Seattle+Sounders&format=json

XML

http://www.sos.wa.gov/corps/search_results.aspx?name_type=starts_with&name=Seattle+Sounders&format=xml

Corporation Details A new version has been released to address the multiple titles for a governing person. Please append "&version=2" to the query string to retrieve a node for each title (XML) or an array of strings (JSON).

URL: http://www.sos.wa.gov/corps/search_detail.aspx

Query String Parameters:

ubi - UBI of the corporation/entity
format - "json" or "xml"
callback - for json format, this value must be supplied for cross-site scripting access. Use "?" with jquery.

Examples:

JSON

http://www.sos.wa.gov/corps/search_detail.aspx?ubi=601810719&format=json&version=2&callback=?

XML

http://www.sos.wa.gov/corps/search_detail.aspx?ubi=601810719&format=xml&version=2

Support and Feedback

We are happy to answer general questions regarding the API. Due to limited resources we cannot offer specific help with the programming or the integration of the output into your application or system.