Catalog / ProPublica Nonprofit Explorer

ProPublica Nonprofit Explorer API

projects.propublica.org

Live read-only access to the structured ProPublica Nonprofit Explorer API. Search organizations, follow EINs to filing-year financial records, and resolve filing object IDs to the site's full-view, schedule, and XML links. The source's People and full-text tabs are server-rendered HTML rather than a structured HTTP feed; they are documented as unavailable under the HTTP-only, no-HTML-parsing policy.

  • Research
  • nonprofits
  • IRS filings
  • finance
  • sports research
3 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.

Then ask your agent to use the ProPublica Nonprofit Explorer API for your task.

Call it over HTTP

Get an API key

Sign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.

Searches ProPublica's documented JSON /search.json endpoint. `page` is zero-indexed. The documented structured endpoint supports q, state[id], ntee[id], and c_code[id]; the website-only revenue, audit, internal-control, travel, conflict, active, and sort controls are not silently sent because the JSON API does not document them.

Optional parameters 5

Keyword or advanced query using the source's q syntax.

Zero-indexed source page.

Two-letter source state or territory code, such as IL or ZZ.

Source NTEE major-group code.

Source subsection code, such as 3 for 501(c)(3).

View call pricing
cURL · Organizations search
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/265369eb-4299-4a59-b344-81a0669acff6/v1/organizations/search' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY"

Endpoints

Inputs and response fields for every endpoint in this API.

GETOrganizations by ein/v1/organizations/{ein}

Returns the structured organization profile and both filing arrays exactly as supplied by ProPublica's organization JSON endpoint.

Input

einRequiredPath · integer

Integer EIN from an organization search result.

Example: 363640583

Response

source_urlstring
api_version?integer | null
data_source?string | null
organizationobject
organization.idinteger
organization.eininteger
organization.city?string | null
organization.name?string | null
organization.state?string | null
organization.address?string | null
organization.zipcode?string | null
organization.have_pdfs?unknown
organization.ntee_code?string | null
organization.sort_name?string | null
organization.asset_code?integer | null
organization.careofname?string | null
organization.created_at?string | null
organization.tax_period?string | null
organization.updated_at?string | null
organization.data_source?string | null
organization.income_code?integer | null
organization.ruling_date?string | null
organization.asset_amount?integer | null
organization.have_extracts?unknown
organization.income_amount?integer | null
organization.activity_codes?string | null
organization.revenue_amount?integer | null
organization.foundation_code?integer | null
organization.subsection_code?integer | null
organization.affiliation_code?integer | null
organization.exemption_number?integer | null
organization.latest_object_id?string | null
organization.accounting_period?integer | null
organization.organization_code?integer | null
organization.deductibility_code?integer | null
organization.classification_codes?string | null
organization.filing_requirement_code?integer | null
organization.pf_filing_requirement_code?integer | null
organization.exempt_organization_status_code?integer | null
page_fields_notestring
filings_with_dataobject[]
filings_with_data[].ein?integer | null
filings_with_data[].tax_pd?integer | string | null
filings_with_data[].netgnls?integer | null
filings_with_data[].pdf_url?string | null
filings_with_data[].tax_prd?integer | null
filings_with_data[].updated?string | null
filings_with_data[].formtype?integer | null
filings_with_data[].gnlsecur?integer | null
filings_with_data[].gnlsothr?integer | null
filings_with_data[].nonpfrea?string | null
filings_with_data[].subseccd?integer | null
filings_with_data[].grsinc170?integer | null
filings_with_data[].payrolltx?integer | null
filings_with_data[].netrntlinc?integer | null
filings_with_data[].royaltsinc?integer | null
filings_with_data[].tax_prd_yr?integer | null
filings_with_data[].totliabend?integer | null
filings_with_data[].totrevenue?integer | null
filings_with_data[].totsupp509?integer | null
filings_with_data[].grsalesecur?integer | null
filings_with_data[].grsalesothr?integer | null
filings_with_data[].grsincother?integer | null
filings_with_data[].grsrntsreal?integer | null
filings_with_data[].invstmntinc?integer | null
filings_with_data[].netincsales?integer | null
filings_with_data[].rntlincreal?integer | null
filings_with_data[].srvcsval170?integer | null
filings_with_data[].srvcsval509?integer | null
filings_with_data[].cstbasisecur?integer | null
filings_with_data[].cstbasisothr?integer | null
filings_with_data[].grsincgaming?integer | null
filings_with_data[].grsrntsprsnl?integer | null
filings_with_data[].netincgaming?integer | null
filings_with_data[].othrsalwages?integer | null
filings_with_data[].rntlincprsnl?integer | null
filings_with_data[].totassetsend?integer | null
filings_with_data[].totcntrbgfts?integer | null
filings_with_data[].totfuncexpns?integer | null
filings_with_data[].grsalesinvent?integer | null
filings_with_data[].grsincfndrsng?integer | null
filings_with_data[].grsincmembers?integer | null
filings_with_data[].lessdirgaming?integer | null
filings_with_data[].miscrevtot11e?integer | null
filings_with_data[].netincfndrsng?integer | null
filings_with_data[].profndraising?integer | null
filings_with_data[].rntlexpnsreal?integer | null
filings_with_data[].secrdmrtgsend?integer | null
filings_with_data[].totprgmrevnue?integer | null
filings_with_data[].unrelbusinccd?string | null
filings_with_data[].initiationfees?integer | null
filings_with_data[].lesscstofgoods?integer | null
filings_with_data[].lessdirfndrsng?integer | null
filings_with_data[].rntlexpnsprsnl?integer | null
filings_with_data[].totnetassetend?integer | null
filings_with_data[].txexmptbndsend?integer | null
filings_with_data[].gftgrntsrcvd170?integer | null
filings_with_data[].retainedearnend?integer | null
filings_with_data[].subtotsuppinc509?integer | null
filings_with_data[].compnsatncurrofcr?integer | null
filings_with_data[].grsrcptspublicuse?integer | null
filings_with_data[].totgftgrntrcvd509?integer | null
filings_with_data[].txrevnuelevied170?integer | null
filings_with_data[].txrevnuelevied509?integer | null
filings_with_data[].unsecurednotesend?integer | null
filings_with_data[].grsrcptsadmissn509?integer | null
filings_with_data[].grsrcptsrelated170?integer | null
filings_with_data[].txexmptbndsproceeds?integer | null
filings_with_data[].pct_compnsatncurrofcr?number | null
filings_without_dataobject[]
filings_without_data[].pdf_url?string | null
filings_without_data[].tax_prd?integer | null
filings_without_data[].formtype?integer | null
filings_without_data[].tax_prd_yr?integer | null
filings_without_data[].formtype_str?string | null

Fields marked ? are optional.

GETFilings by ein by object id/v1/filings/{ein}/{object_id}

Uses the live organization JSON and performs HTTP metadata checks against the canonical full-view, optional schedule, and XML links. ProPublica does not expose a filing-object JSON endpoint; the object ID is source-validated only when it equals the structured profile's latest_object_id. Rendered full-view and schedule pages are HTML, so their labels are not parsed into invented fields.

Input

einRequiredPath · integer

Integer EIN from an organization search result.

Example: 363640583

object_idRequiredPath · string

Filing object ID copied from the organization's source page.

Example: 202641209349301874

scheduleOptionalQuery · string | null

Optional source schedule name, such as IRS990ScheduleJ.

Example: IRS990ScheduleJ

Response

eininteger
linksobject
links.pdf_url?string | null
links.xml_urlstring
links.schedule_url?string | null
links.full_view_urlstring
links.pdf_mapping_availableboolean
object_idstring
organizationobject
organization.idinteger
organization.eininteger
organization.city?string | null
organization.name?string | null
organization.state?string | null
organization.address?string | null
organization.zipcode?string | null
organization.have_pdfs?unknown
organization.ntee_code?string | null
organization.sort_name?string | null
organization.asset_code?integer | null
organization.careofname?string | null
organization.created_at?string | null
organization.tax_period?string | null
organization.updated_at?string | null
organization.data_source?string | null
organization.income_code?integer | null
organization.ruling_date?string | null
organization.asset_amount?integer | null
organization.have_extracts?unknown
organization.income_amount?integer | null
organization.activity_codes?string | null
organization.revenue_amount?integer | null
organization.foundation_code?integer | null
organization.subsection_code?integer | null
organization.affiliation_code?integer | null
organization.exemption_number?integer | null
organization.latest_object_id?string | null
organization.accounting_period?integer | null
organization.organization_code?integer | null
organization.deductibility_code?integer | null
organization.classification_codes?string | null
organization.filing_requirement_code?integer | null
organization.pf_filing_requirement_code?integer | null
organization.exempt_organization_status_code?integer | null
source_checksobject[]
source_checks[].url?string | null
source_checks[].kindstring
source_checks[].bytes?integer | null
source_checks[].error?string | null
source_checks[].status?integer | null
source_checks[].content_type?string | null
source_filing?object
source_filing.ein?integer | null
source_filing.tax_pd?integer | string | null
source_filing.netgnls?integer | null
source_filing.pdf_url?string | null
source_filing.tax_prd?integer | null
source_filing.updated?string | null
source_filing.formtype?integer | null
source_filing.gnlsecur?integer | null
source_filing.gnlsothr?integer | null
source_filing.nonpfrea?string | null
source_filing.subseccd?integer | null
source_filing.grsinc170?integer | null
source_filing.payrolltx?integer | null
source_filing.netrntlinc?integer | null
source_filing.royaltsinc?integer | null
source_filing.tax_prd_yr?integer | null
source_filing.totliabend?integer | null
source_filing.totrevenue?integer | null
source_filing.totsupp509?integer | null
source_filing.grsalesecur?integer | null
source_filing.grsalesothr?integer | null
source_filing.grsincother?integer | null
source_filing.grsrntsreal?integer | null
source_filing.invstmntinc?integer | null
source_filing.netincsales?integer | null
source_filing.rntlincreal?integer | null
source_filing.srvcsval170?integer | null
source_filing.srvcsval509?integer | null
source_filing.cstbasisecur?integer | null
source_filing.cstbasisothr?integer | null
source_filing.grsincgaming?integer | null
source_filing.grsrntsprsnl?integer | null
source_filing.netincgaming?integer | null
source_filing.othrsalwages?integer | null
source_filing.rntlincprsnl?integer | null
source_filing.totassetsend?integer | null
source_filing.totcntrbgfts?integer | null
source_filing.totfuncexpns?integer | null
source_filing.grsalesinvent?integer | null
source_filing.grsincfndrsng?integer | null
source_filing.grsincmembers?integer | null
source_filing.lessdirgaming?integer | null
source_filing.miscrevtot11e?integer | null
source_filing.netincfndrsng?integer | null
source_filing.profndraising?integer | null
source_filing.rntlexpnsreal?integer | null
source_filing.secrdmrtgsend?integer | null
source_filing.totprgmrevnue?integer | null
source_filing.unrelbusinccd?string | null
source_filing.initiationfees?integer | null
source_filing.lesscstofgoods?integer | null
source_filing.lessdirfndrsng?integer | null
source_filing.rntlexpnsprsnl?integer | null
source_filing.totnetassetend?integer | null
source_filing.txexmptbndsend?integer | null
source_filing.gftgrntsrcvd170?integer | null
source_filing.retainedearnend?integer | null
source_filing.subtotsuppinc509?integer | null
source_filing.compnsatncurrofcr?integer | null
source_filing.grsrcptspublicuse?integer | null
source_filing.totgftgrntrcvd509?integer | null
source_filing.txrevnuelevied170?integer | null
source_filing.txrevnuelevied509?integer | null
source_filing.unsecurednotesend?integer | null
source_filing.grsrcptsadmissn509?integer | null
source_filing.grsrcptsrelated170?integer | null
source_filing.txexmptbndsproceeds?integer | null
source_filing.pct_compnsatncurrofcr?number | null
pdf_links_notestring
resolution_notestring
requested_schedule?string | null
rendered_content_notestring
resolved_by_structured_sourceboolean

Fields marked ? are optional.

Don’t see the endpoint you need?

Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.