# ProPublica Nonprofit IRS 990 History by EIN

> ProPublica Nonprofit IRS 990 History by EIN is a paid API for AI agents from vaaya.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns the full IRS Form 990 filing history for a single nonprofit by EIN, including year-by-year revenue, expenses, officer compensation, assets, and links to filed PDF documents.

## Facts

- Endpoint: POST https://vaaya.ai/api/run/propublica/nonprofit
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/propublica-nonprofit-irs-990-history-by-ein-5a847121
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QdyOv3SGCRIqqDltAXwEm

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability propublica-nonprofit-irs-990-history-by-ein-5a847121 -d '<json body>'
```

Example prompt: Pull up the full IRS 990 filing history for the Bill & Melinda Gates Foundation — EIN 56-2618866 — I want to see their year-by-year revenue, expenses, officer pay, and links to the actual filed PDFs.

## When to prefer this

Use this endpoint when you need historical IRS 990 financial data for a specific U.S. nonprofit and already have or can find its EIN. It is the definitive source for year-over-year revenue, expenses, officer compensation, and asset data from official filings. Prefer this over general web search when you need structured, machine-readable financial data directly from tax filings rather than press releases or charity rating summaries.

## Known failure modes

- EIN not found in ProPublica database — organization may not file 990s (e.g. churches) or EIN is incorrect
- No 990 history available for very new organizations or those recently granted tax-exempt status
- Malformed EIN input causing lookup failure
- ProPublica upstream API timeout or rate limit
- Some older filings may lack PDF links if not digitized

## How this service works

One nonprofit's full IRS 990 history by EIN (ProPublica): year-by-year revenue, expenses, officer compensation, assets, plus links to the filed 990 PDFs. The primary source for "what does this NGO/foundation actually take in and pay out".

## Output

A structured year-by-year breakdown of the nonprofit's IRS 990 filings, including total revenue, total expenses, officer and key employee compensation, total assets, tax year, and direct links to the original PDF filings on record.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "$schema": "http://json-schema.org/draft-07/schema#",
     "required": [
      "ein"
     ],
     "properties": {
      "ein": {
       "anyOf": [
        {
         "type": "string",
         "pattern": "^\\d{2}-?\\d{7}$"
        },
        {
         "type": "integer",
         "exclusiveMinimum": 0
        }
       ]
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/propublica-nonprofit-irs-990-history-by-ein-5a847121/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vaaya.ai](https://www.zero.xyz/host/vaaya.ai/llms.txt)