# US Nonprofit Search by Name

> US Nonprofit Search by Name is a paid API for AI agents from payai.agentstools.dev, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-15).

Resolves a US nonprofit organization name to ranked candidate matches with EIN, location, NTEE category, and 501(c) subsection.

## Facts

- Endpoint: GET https://payai.agentstools.dev/nonprofit/search
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-nonprofit-search-by-name-106c82c5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__Mma_SZjGPOVHSvRgTtA7

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 us-nonprofit-search-by-name-106c82c5
```

Example prompt: Can you find the EIN for a nonprofit called 'Feeding America' — look in Illinois and limit results to the top 5 matches?

## When to prefer this

Use this endpoint as the first step when you have a nonprofit name and need to resolve it to a canonical EIN for further downstream lookups or financial transactions. It is ideal for name-to-EIN disambiguation workflows, especially when you can narrow by state or NTEE category. Prefer it over manual IRS searches or unstructured web lookups because it returns structured, ranked candidates with match scores at low cost ($0.008 per call).

## Known failure modes

- No results returned when name is too vague or misspelled
- Ambiguous matches when many organizations share similar names — requires state or NTEE filter to narrow down
- Invalid state code or out-of-range NTEE/c_code values may cause a 400 error
- Rate-limit or payment failure if USDC balance is insufficient (x402 payment required)
- Very new or obscure nonprofits may not appear if not yet indexed in the underlying IRS dataset

## How this service works

Resolve a US nonprofit name to ranked candidate organizations, each with EIN, name, city, state, decoded NTEE, subsection and a match score. The cheap first step for EIN-to-name disambiguation, optionally narrowed by state, NTEE category or 501(c) subsection.

## Output

A ranked list of candidate US nonprofit organizations matching the search name, each containing the EIN, organization name, city, state, decoded NTEE category label, 501(c) subsection code, and a numeric match score indicating relevance.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "name"
     ],
     "properties": {
      "name": {
       "type": "string",
       "description": "Organization name to search"
      },
      "ntee": {
       "type": "integer",
       "maximum": 10,
       "minimum": 1,
       "description": "Optional NTEE category id (1 to 10)"
      },
      "limit": {
       "type": "integer",
       "maximum": 25,
       "minimum": 1,
       "description": "Maximum candidates to return (default 10)"
      },
      "state": {
       "type": "string",
       "examples": [
        "NY",
        "CA",
        "DC"
       ],
       "description": "Optional 2-letter US state filter"
      },
      "c_code": {
       "type": "integer",
       "description": "Optional 501(c) subsection number, e.g. 3"
      }
     }
    }
   },
   "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/us-nonprofit-search-by-name-106c82c5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payai.agentstools.dev](https://www.zero.xyz/host/payai.agentstools.dev/llms.txt)