Open990 API

Open990 offers a customizable RESTful API that facilitates the incorporation of data into your internal system. Through the API, selected variables can be retrieved on demand in .json or .xml. We provide limited customization of the API interface at no additional charge.

Try our demo APIs!

You can try our APIs for free at demo.open990.com. No API key is needed. To get started, click here to view the list of 98 searchable organizations. These identifiers can be used as parameters in the endpoints. All endpoints return JSON values in non-error cases. APIs are HATEAOS compliant, meaning that they provide URLs necessary to repeat the request and/or to navigate to related requests.

API endpoint classes

Click below to read more about the several API options you have to unlock the potential of IRS Form 990 e-file data.

Search endpoints

Query available filings for information of interest.

Entity endpoints

Provide an overview of available information on a particular organization.

Detail endpoints

Provide a set of data points for a specified tax year and organization.

Simple search API

https://demo.open990.com/search/searchterm

Performs a full-text search for organizations relevant to searchterm. To be relevant, the organization must have a name similar to searchterm. Simple search does not consider personnel names.

A match is any filing from the organization is considered a match for the organization. Results are sorted by the relevance score of the most relevant filing.

Example:

https://demo.open990.com/search/liberties


Advanced search API

https://demo.open990.com/advanced_search?option1=value&option2=value...

Performs a search using the specified options. A match is any filing from the organization is considered a match for the organization. If a fulltext option is used (e.g. org_name), results are sorted by the relevance score of the most relevant filing. Otherwise, sort order is arbitrary. If no parameters are specified, a 400 bad request error occurs.

Parameters:
  • org_name: Results score higher if their names are similar to org_name.
  • address: Either the organization or one of its facilities must be similar to address.
  • city: Either the organization or one of its facilities must be similar to city.
  • state: 2-digit state code. Either the organization or one of its facilities must have an address in this state.
  • zip: Either the organization or one of its facilities must have this exact ZIP code.
  • person_name: At least one person reported on this organization’s filings must have a name similar to this one.
  • ein: The organization must have this exact EIN.
Example:

https://demo.open990.com/advanced_search?org_name=consumer+electronics&state=va

Simple entity API

https://demo.open990.com/entity/ein

Returns all filing details associated with the specified filing. For this demo, this endpoint is reporting a subset of data that 990 Consulting has mapped from the given entity. If the filing does not exist, a 404 not found error occurs.

Example:

https://demo.open990.com/entity/411357750

The filing detail API

https://demo.open990.com/filing/object_id

Returns all filing details associated with the specified filing. For this demo, this endpoint is reporting a subset of data that 990 Consulting has mapped from the given entity. If the filing does not exist, a 404 not found error occurs.

Example:

https://demo.open990.com/filing/201412269349301211