ProPublica Nonprofit Explorer API
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.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn 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 keySign 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.
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 search/v1/organizations/search
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.
Input
qOptionalQuery · string | nullKeyword or advanced query using the source's q syntax.
Example: Big Ten
pageOptionalQuery · integer, min: 0, default: 0Zero-indexed source page.
Example: 0
stateOptionalQuery · string | nullTwo-letter source state or territory code, such as IL or ZZ.
Example: IL
nteeOptionalQuery · integer, min: 1, max: 10 | nullSource NTEE major-group code.
Example: 2
c_codeOptionalQuery · integer | nullSource subsection code, such as 3 for 501(c)(3).
Example: 3
Response
cur_page?integer | nullper_page?integer | nullnum_pages?integer | nullapi_version?integer | nulldata_source?string | nullpage_offset?integer | nullsearch_query?string | nullorganizationsobject[]organizations[].einintegerorganizations[].url?string | nullorganizations[].city?string | nullorganizations[].name?string | nullorganizations[].score?number | nullorganizations[].state?string | nullorganizations[].strein?string | nullorganizations[].sub_name?string | nullorganizations[].subseccd?integer | nullorganizations[].have_pdfs?unknownorganizations[].ntee_code?string | nullorganizations[].has_subseccd?boolean | nullorganizations[].have_filings?unknownorganizations[].have_extracts?unknownorganizations[].raw_ntee_code?string | nullselected_code?string | nullselected_ntee?string | nulltotal_resultsintegerselected_state?string | nullFields marked ? are optional.
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 · integerInteger EIN from an organization search result.
Example: 363640583
Response
source_urlstringapi_version?integer | nulldata_source?string | nullorganizationobjectorganization.idintegerorganization.einintegerorganization.city?string | nullorganization.name?string | nullorganization.state?string | nullorganization.address?string | nullorganization.zipcode?string | nullorganization.have_pdfs?unknownorganization.ntee_code?string | nullorganization.sort_name?string | nullorganization.asset_code?integer | nullorganization.careofname?string | nullorganization.created_at?string | nullorganization.tax_period?string | nullorganization.updated_at?string | nullorganization.data_source?string | nullorganization.income_code?integer | nullorganization.ruling_date?string | nullorganization.asset_amount?integer | nullorganization.have_extracts?unknownorganization.income_amount?integer | nullorganization.activity_codes?string | nullorganization.revenue_amount?integer | nullorganization.foundation_code?integer | nullorganization.subsection_code?integer | nullorganization.affiliation_code?integer | nullorganization.exemption_number?integer | nullorganization.latest_object_id?string | nullorganization.accounting_period?integer | nullorganization.organization_code?integer | nullorganization.deductibility_code?integer | nullorganization.classification_codes?string | nullorganization.filing_requirement_code?integer | nullorganization.pf_filing_requirement_code?integer | nullorganization.exempt_organization_status_code?integer | nullpage_fields_notestringfilings_with_dataobject[]filings_with_data[].ein?integer | nullfilings_with_data[].tax_pd?integer | string | nullfilings_with_data[].netgnls?integer | nullfilings_with_data[].pdf_url?string | nullfilings_with_data[].tax_prd?integer | nullfilings_with_data[].updated?string | nullfilings_with_data[].formtype?integer | nullfilings_with_data[].gnlsecur?integer | nullfilings_with_data[].gnlsothr?integer | nullfilings_with_data[].nonpfrea?string | nullfilings_with_data[].subseccd?integer | nullfilings_with_data[].grsinc170?integer | nullfilings_with_data[].payrolltx?integer | nullfilings_with_data[].netrntlinc?integer | nullfilings_with_data[].royaltsinc?integer | nullfilings_with_data[].tax_prd_yr?integer | nullfilings_with_data[].totliabend?integer | nullfilings_with_data[].totrevenue?integer | nullfilings_with_data[].totsupp509?integer | nullfilings_with_data[].grsalesecur?integer | nullfilings_with_data[].grsalesothr?integer | nullfilings_with_data[].grsincother?integer | nullfilings_with_data[].grsrntsreal?integer | nullfilings_with_data[].invstmntinc?integer | nullfilings_with_data[].netincsales?integer | nullfilings_with_data[].rntlincreal?integer | nullfilings_with_data[].srvcsval170?integer | nullfilings_with_data[].srvcsval509?integer | nullfilings_with_data[].cstbasisecur?integer | nullfilings_with_data[].cstbasisothr?integer | nullfilings_with_data[].grsincgaming?integer | nullfilings_with_data[].grsrntsprsnl?integer | nullfilings_with_data[].netincgaming?integer | nullfilings_with_data[].othrsalwages?integer | nullfilings_with_data[].rntlincprsnl?integer | nullfilings_with_data[].totassetsend?integer | nullfilings_with_data[].totcntrbgfts?integer | nullfilings_with_data[].totfuncexpns?integer | nullfilings_with_data[].grsalesinvent?integer | nullfilings_with_data[].grsincfndrsng?integer | nullfilings_with_data[].grsincmembers?integer | nullfilings_with_data[].lessdirgaming?integer | nullfilings_with_data[].miscrevtot11e?integer | nullfilings_with_data[].netincfndrsng?integer | nullfilings_with_data[].profndraising?integer | nullfilings_with_data[].rntlexpnsreal?integer | nullfilings_with_data[].secrdmrtgsend?integer | nullfilings_with_data[].totprgmrevnue?integer | nullfilings_with_data[].unrelbusinccd?string | nullfilings_with_data[].initiationfees?integer | nullfilings_with_data[].lesscstofgoods?integer | nullfilings_with_data[].lessdirfndrsng?integer | nullfilings_with_data[].rntlexpnsprsnl?integer | nullfilings_with_data[].totnetassetend?integer | nullfilings_with_data[].txexmptbndsend?integer | nullfilings_with_data[].gftgrntsrcvd170?integer | nullfilings_with_data[].retainedearnend?integer | nullfilings_with_data[].subtotsuppinc509?integer | nullfilings_with_data[].compnsatncurrofcr?integer | nullfilings_with_data[].grsrcptspublicuse?integer | nullfilings_with_data[].totgftgrntrcvd509?integer | nullfilings_with_data[].txrevnuelevied170?integer | nullfilings_with_data[].txrevnuelevied509?integer | nullfilings_with_data[].unsecurednotesend?integer | nullfilings_with_data[].grsrcptsadmissn509?integer | nullfilings_with_data[].grsrcptsrelated170?integer | nullfilings_with_data[].txexmptbndsproceeds?integer | nullfilings_with_data[].pct_compnsatncurrofcr?number | nullfilings_without_dataobject[]filings_without_data[].pdf_url?string | nullfilings_without_data[].tax_prd?integer | nullfilings_without_data[].formtype?integer | nullfilings_without_data[].tax_prd_yr?integer | nullfilings_without_data[].formtype_str?string | nullFields 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 · integerInteger EIN from an organization search result.
Example: 363640583
object_idRequiredPath · stringFiling object ID copied from the organization's source page.
Example: 202641209349301874
scheduleOptionalQuery · string | nullOptional source schedule name, such as IRS990ScheduleJ.
Example: IRS990ScheduleJ
Response
einintegerlinksobjectlinks.pdf_url?string | nulllinks.xml_urlstringlinks.schedule_url?string | nulllinks.full_view_urlstringlinks.pdf_mapping_availablebooleanobject_idstringorganizationobjectorganization.idintegerorganization.einintegerorganization.city?string | nullorganization.name?string | nullorganization.state?string | nullorganization.address?string | nullorganization.zipcode?string | nullorganization.have_pdfs?unknownorganization.ntee_code?string | nullorganization.sort_name?string | nullorganization.asset_code?integer | nullorganization.careofname?string | nullorganization.created_at?string | nullorganization.tax_period?string | nullorganization.updated_at?string | nullorganization.data_source?string | nullorganization.income_code?integer | nullorganization.ruling_date?string | nullorganization.asset_amount?integer | nullorganization.have_extracts?unknownorganization.income_amount?integer | nullorganization.activity_codes?string | nullorganization.revenue_amount?integer | nullorganization.foundation_code?integer | nullorganization.subsection_code?integer | nullorganization.affiliation_code?integer | nullorganization.exemption_number?integer | nullorganization.latest_object_id?string | nullorganization.accounting_period?integer | nullorganization.organization_code?integer | nullorganization.deductibility_code?integer | nullorganization.classification_codes?string | nullorganization.filing_requirement_code?integer | nullorganization.pf_filing_requirement_code?integer | nullorganization.exempt_organization_status_code?integer | nullsource_checksobject[]source_checks[].url?string | nullsource_checks[].kindstringsource_checks[].bytes?integer | nullsource_checks[].error?string | nullsource_checks[].status?integer | nullsource_checks[].content_type?string | nullsource_filing?objectsource_filing.ein?integer | nullsource_filing.tax_pd?integer | string | nullsource_filing.netgnls?integer | nullsource_filing.pdf_url?string | nullsource_filing.tax_prd?integer | nullsource_filing.updated?string | nullsource_filing.formtype?integer | nullsource_filing.gnlsecur?integer | nullsource_filing.gnlsothr?integer | nullsource_filing.nonpfrea?string | nullsource_filing.subseccd?integer | nullsource_filing.grsinc170?integer | nullsource_filing.payrolltx?integer | nullsource_filing.netrntlinc?integer | nullsource_filing.royaltsinc?integer | nullsource_filing.tax_prd_yr?integer | nullsource_filing.totliabend?integer | nullsource_filing.totrevenue?integer | nullsource_filing.totsupp509?integer | nullsource_filing.grsalesecur?integer | nullsource_filing.grsalesothr?integer | nullsource_filing.grsincother?integer | nullsource_filing.grsrntsreal?integer | nullsource_filing.invstmntinc?integer | nullsource_filing.netincsales?integer | nullsource_filing.rntlincreal?integer | nullsource_filing.srvcsval170?integer | nullsource_filing.srvcsval509?integer | nullsource_filing.cstbasisecur?integer | nullsource_filing.cstbasisothr?integer | nullsource_filing.grsincgaming?integer | nullsource_filing.grsrntsprsnl?integer | nullsource_filing.netincgaming?integer | nullsource_filing.othrsalwages?integer | nullsource_filing.rntlincprsnl?integer | nullsource_filing.totassetsend?integer | nullsource_filing.totcntrbgfts?integer | nullsource_filing.totfuncexpns?integer | nullsource_filing.grsalesinvent?integer | nullsource_filing.grsincfndrsng?integer | nullsource_filing.grsincmembers?integer | nullsource_filing.lessdirgaming?integer | nullsource_filing.miscrevtot11e?integer | nullsource_filing.netincfndrsng?integer | nullsource_filing.profndraising?integer | nullsource_filing.rntlexpnsreal?integer | nullsource_filing.secrdmrtgsend?integer | nullsource_filing.totprgmrevnue?integer | nullsource_filing.unrelbusinccd?string | nullsource_filing.initiationfees?integer | nullsource_filing.lesscstofgoods?integer | nullsource_filing.lessdirfndrsng?integer | nullsource_filing.rntlexpnsprsnl?integer | nullsource_filing.totnetassetend?integer | nullsource_filing.txexmptbndsend?integer | nullsource_filing.gftgrntsrcvd170?integer | nullsource_filing.retainedearnend?integer | nullsource_filing.subtotsuppinc509?integer | nullsource_filing.compnsatncurrofcr?integer | nullsource_filing.grsrcptspublicuse?integer | nullsource_filing.totgftgrntrcvd509?integer | nullsource_filing.txrevnuelevied170?integer | nullsource_filing.txrevnuelevied509?integer | nullsource_filing.unsecurednotesend?integer | nullsource_filing.grsrcptsadmissn509?integer | nullsource_filing.grsrcptsrelated170?integer | nullsource_filing.txexmptbndsproceeds?integer | nullsource_filing.pct_compnsatncurrofcr?number | nullpdf_links_notestringresolution_notestringrequested_schedule?string | nullrendered_content_notestringresolved_by_structured_sourcebooleanFields 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.
An account is required to submit an extension. Prepare your request, then sign in to build.