{"components":{"responses":{},"schemas":{"CurrentFinancials":{"description":"Reconciled best-available current financials (source: efile > soi > bmf).","nullable":true,"properties":{"net_assets_eoy":{"nullable":true,"type":"integer"},"source":{"enum":["efile","soi","bmf"],"type":"string"},"tax_period":{"nullable":true,"type":"string"},"total_assets_eoy":{"nullable":true,"type":"integer"},"total_expenses":{"nullable":true,"type":"integer"},"total_liabilities_eoy":{"nullable":true,"type":"integer"},"total_revenue":{"nullable":true,"type":"integer"}},"title":"CurrentFinancials","type":"object"},"Error":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"Error","type":"object"},"Filing":{"properties":{"object_id":{"type":"string"},"parsed_at":{"format":"date-time","nullable":true,"type":"string"},"return_type":{"nullable":true,"type":"string"},"return_version":{"nullable":true,"type":"string"},"submission_date":{"format":"date","nullable":true,"type":"string"},"tax_period":{"nullable":true,"type":"string"}},"title":"Filing","type":"object"},"FilingsData":{"properties":{"efile":{"items":{"$ref":"#/components/schemas/Filing"},"type":"array"},"soi_years":{"items":{"type":"object"},"type":"array"}},"title":"FilingsData","type":"object"},"FilingsResponse":{"properties":{"data":{"$ref":"#/components/schemas/FilingsData"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"],"title":"FilingsResponse","type":"object"},"FinancialRow":{"description":"One financial period from the SOI or e-file track, source-tagged.","properties":{"as_of":{"format":"date","nullable":true,"type":"string"},"contributions_grants":{"nullable":true,"type":"integer"},"grants_paid":{"nullable":true,"type":"integer"},"investment_income":{"nullable":true,"type":"integer"},"is_paper_filed":{"nullable":true,"type":"boolean"},"net_assets_eoy":{"nullable":true,"type":"integer"},"object_id":{"nullable":true,"type":"string"},"program_service_revenue":{"nullable":true,"type":"integer"},"public_support_total":{"nullable":true,"type":"integer"},"return_type":{"nullable":true,"type":"string"},"source":{"enum":["soi","efile"],"type":"string"},"tax_period":{"nullable":true,"type":"string"},"total_assets_eoy":{"nullable":true,"type":"integer"},"total_compensation":{"nullable":true,"type":"integer"},"total_expenses":{"nullable":true,"type":"integer"},"total_liabilities_eoy":{"nullable":true,"type":"integer"},"total_revenue":{"nullable":true,"type":"integer"}},"title":"FinancialRow","type":"object"},"FinancialsResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/FinancialRow"},"type":"array"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"],"title":"FinancialsResponse","type":"object"},"Grant":{"description":"Schedule I grant made by the filer.","properties":{"amount_cash":{"nullable":true,"type":"integer"},"amount_noncash":{"nullable":true,"type":"integer"},"irc_section":{"nullable":true,"type":"string"},"purpose":{"nullable":true,"type":"string"},"recipient_address":{"nullable":true,"type":"string"},"recipient_ein":{"nullable":true,"type":"string"},"recipient_name":{"nullable":true,"type":"string"}},"title":"Grant","type":"object"},"GrantsResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Grant"},"type":"array"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"],"title":"GrantsResponse","type":"object"},"Meta":{"description":"Envelope metadata present on every response (warranty notice; pagination on lists).","properties":{"api_version":{"example":"v1","type":"string"},"pagination":{"nullable":true,"properties":{"page":{"type":"integer"},"per_page":{"type":"integer"},"sort":{"type":"string"},"total":{"type":"integer"},"total_pages":{"type":"integer"}},"type":"object"},"warranty":{"description":"No-warranty-of-accuracy notice.","type":"string"}},"required":["api_version","warranty"],"title":"Meta","type":"object"},"OrgProfile":{"description":"Full organization profile.","properties":{"address":{"type":"object"},"bmf_as_of":{"format":"date","nullable":true,"type":"string"},"classification":{"type":"object"},"counts":{"properties":{"efile_filings":{"type":"integer"},"grants":{"type":"integer"},"people":{"type":"integer"},"soi_filings":{"type":"integer"}},"type":"object"},"current_financials":{"$ref":"#/components/schemas/CurrentFinancials"},"dba_name":{"nullable":true,"type":"string"},"ein":{"type":"string"},"in_care_of_name":{"nullable":true,"type":"string"},"name":{"nullable":true,"type":"string"},"status":{"type":"object"}},"required":["ein"],"title":"OrgProfile","type":"object"},"OrgProfileResponse":{"properties":{"data":{"$ref":"#/components/schemas/OrgProfile"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"],"title":"OrgProfileResponse","type":"object"},"OrgSearchResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/OrgSummary"},"type":"array"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"],"title":"OrgSearchResponse","type":"object"},"OrgSummary":{"description":"Lightweight org row returned by search.","properties":{"city":{"nullable":true,"type":"string"},"current_financials":{"$ref":"#/components/schemas/CurrentFinancials"},"ein":{"type":"string"},"is_501c3":{"nullable":true,"type":"boolean"},"name":{"nullable":true,"type":"string"},"ntee_code":{"nullable":true,"type":"string"},"state":{"nullable":true,"type":"string"},"subsection_code":{"nullable":true,"type":"string"},"subsection_label":{"nullable":true,"type":"string"}},"required":["ein"],"title":"OrgSummary","type":"object"},"PeopleResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Person"},"type":"array"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"],"title":"PeopleResponse","type":"object"},"Person":{"description":"Form 990 Part VII officer/director/key employee (public).","properties":{"avg_hours_per_week":{"nullable":true,"type":"number"},"is_director":{"nullable":true,"type":"boolean"},"is_highest_compensated":{"nullable":true,"type":"boolean"},"is_key_employee":{"nullable":true,"type":"boolean"},"is_officer":{"nullable":true,"type":"boolean"},"name":{"nullable":true,"type":"string"},"other_comp":{"nullable":true,"type":"integer"},"reportable_comp_org":{"nullable":true,"type":"integer"},"reportable_comp_related":{"nullable":true,"type":"integer"},"title":{"nullable":true,"type":"string"}},"title":"Person","type":"object"},"Stats":{"description":"Corpus aggregates for the landing page.","properties":{"by_source":{"description":"How many orgs' current figure was won by each source.","properties":{"bmf":{"type":"integer"},"efile":{"type":"integer"},"soi":{"type":"integer"}},"type":"object"},"c3_orgs":{"description":"Count of 501(c)(3) charities","type":"integer"},"revoked_orgs":{"description":"Count with a revocation on record","type":"integer"},"total_orgs":{"description":"Total organizations in the registry","type":"integer"}},"title":"Stats","type":"object"},"StatsResponse":{"properties":{"data":{"$ref":"#/components/schemas/Stats"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"],"title":"StatsResponse","type":"object"},"SuggestResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Suggestion"},"type":"array"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"],"title":"SuggestResponse","type":"object"},"Suggestion":{"description":"A typeahead suggestion: EIN + name only.","properties":{"ein":{"type":"string"},"name":{"nullable":true,"type":"string"}},"title":"Suggestion","type":"object"}}},"info":{"description":"Read-only JSON API over public-domain U.S. IRS tax-exempt organization data (EO BMF registry, SOI financial extract, e-file 990 slice). All data is provided AS IS, without warranty of accuracy — see each response's `meta.warranty`.","title":"501api — Public 501(c) Nonprofit Data API","version":"1.0.0"},"openapi":"3.0.0","paths":{"/v1/orgs":{"get":{"callbacks":{},"description":"Full-text search on name/dba + filters; paginated and sortable.","operationId":"Five01apiWeb.V1.OrgController.index","parameters":[{"description":"Full-text query over name/dba/city","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"Two-letter state (exact)","in":"query","name":"state","required":false,"schema":{"type":"string"}},{"description":"NTEE code prefix","in":"query","name":"ntee","required":false,"schema":{"type":"string"}},{"description":"501(c) subsection code, e.g. 03","in":"query","name":"subsection","required":false,"schema":{"type":"string"}},{"description":"Scope to/away from charities","in":"query","name":"is_501c3","required":false,"schema":{"type":"boolean"}},{"description":"Min reconciled current revenue","in":"query","name":"revenue_min","required":false,"schema":{"type":"integer"}},{"description":"Max reconciled current revenue","in":"query","name":"revenue_max","required":false,"schema":{"type":"integer"}},{"description":"revenue | assets | name","in":"query","name":"sort","required":false,"schema":{"type":"string"}},{"description":"1-based page","in":"query","name":"page","required":false,"schema":{"type":"integer"}},{"description":"Page size (max 100)","in":"query","name":"per_page","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrgSearchResponse"}}},"description":"Search results"}},"summary":"Search organizations","tags":[]}},"/v1/orgs/suggest":{"get":{"callbacks":{},"operationId":"Five01apiWeb.V1.OrgController.suggest","parameters":[{"description":"Prefix to complete","in":"query","name":"q","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuggestResponse"}}},"description":"Suggestions"}},"summary":"Typeahead suggestions (EIN + name) for the search box","tags":[]}},"/v1/orgs/{ein}":{"get":{"callbacks":{},"operationId":"Five01apiWeb.V1.OrgController.show","parameters":[{"description":"Employer Identification Number (TEXT; leading zeros preserved)","in":"path","name":"ein","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrgProfileResponse"}}},"description":"Org profile"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown EIN"}},"summary":"Get an organization profile by EIN","tags":[]}},"/v1/orgs/{ein}/filings":{"get":{"callbacks":{},"operationId":"Five01apiWeb.V1.OrgController.filings","parameters":[{"description":"Employer Identification Number (TEXT; leading zeros preserved)","in":"path","name":"ein","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingsResponse"}}},"description":"Filings"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown EIN"}},"summary":"Filings for an organization (e-file returns + SOI years)","tags":[]}},"/v1/orgs/{ein}/financials":{"get":{"callbacks":{},"operationId":"Five01apiWeb.V1.OrgController.financials","parameters":[{"description":"Employer Identification Number (TEXT; leading zeros preserved)","in":"path","name":"ein","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinancialsResponse"}}},"description":"Financial history"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown EIN"}},"summary":"Financial time series (SOI + e-file) for an organization","tags":[]}},"/v1/orgs/{ein}/grants":{"get":{"callbacks":{},"operationId":"Five01apiWeb.V1.OrgController.grants","parameters":[{"description":"Employer Identification Number (TEXT; leading zeros preserved)","in":"path","name":"ein","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GrantsResponse"}}},"description":"Grants"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown EIN"}},"summary":"Schedule I grants made by an organization","tags":[]}},"/v1/orgs/{ein}/people":{"get":{"callbacks":{},"operationId":"Five01apiWeb.V1.OrgController.people","parameters":[{"description":"Employer Identification Number (TEXT; leading zeros preserved)","in":"path","name":"ein","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PeopleResponse"}}},"description":"People"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown EIN"}},"summary":"Part VII people (officers/directors/key employees) for an organization","tags":[]}},"/v1/stats":{"get":{"callbacks":{},"operationId":"Five01apiWeb.V1.StatsController.show","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatsResponse"}}},"description":"Stats"}},"summary":"Corpus aggregates (total orgs, charity/revoked counts, by source)","tags":[]}}},"security":[],"servers":[{"url":"https://501api.org","variables":{}}],"tags":[]}