GET
/
v2
/
orgs
/
search
curl --request GET \
  --url https://api.endaoment.org/v2/orgs/search
[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "ein": "530196605",
    "name": "American Red Cross",
    "description": "Providing disaster relief and emergency assistance",
    "address": {
      "line1": "123 Main St",
      "city": "San Francisco",
      "state": "CA",
      "zip": "94105",
      "country": "USA"
    },
    "logo": "https://example.com/logo.png",
    "nteeCode": "M20",
    "nteeDescription": "Disaster Preparedness and Relief Services",
    "featuredIndex": 1,
    "isCompliant": true,
    "lifetimeContributionsUsdc": "1000000000",
    "donationsReceived": 42,
    "grantsReceived": 15
  }
]

Query Parameters

​
searchTerm
string

Full-text search term to find organizations by name or EIN

​
nteeMajorCodes
string

Comma-separated list of NTEE Major Codes to filter organizations by

​
nteeMinorCodes
string

Comma-separated list of NTEE Minor Codes to filter organizations by

​
countries
string

Comma-separated list of ISO 3166-1 alpha-3 country codes to filter organizations by. Example values: USA, CAN, etc.

​
subdivisions
string

Comma-separated list of US state codes to filter organizations by. Possible values: AL, AK, AZ, AR, CA, CO, CT, DE, DC, FL, GA, HI, ID, IL, IN, IA, KS, KY, LA, ME, MD, MA, MI, MN, MS, MO, MT, NE, NV, NH, NJ, NM, NY, NC, ND, OH, OK, OR, PA, RI, SC, SD, TN, TX, UT, VT, VA, WA, WV, WI, WY

​
status
string

Comma-separated list of organization statuses to filter by. Possible values: claimed, unclaimed

​
count
number
default:10

Maximum number of results to return

Required range: 1 <= x <= 25
​
offset
number
default:0

Number of results to skip for pagination

Required range: x >= 0

Response

200 - application/json
List of organizations matching the search criteria
​
id
string | null
required

Unique identifier of the organization in Endaoment database

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
ein
string | null
required

IRS Employer Identification Number (EIN) without hyphen. Value will not be present for international orgs

Example:

"530196605"

​
name
string
required

Name of the organization

Example:

"American Red Cross"

​
description
string | null
required

Description or mission statement of the organization

Example:

"Providing disaster relief and emergency assistance"

​
address
object
required

Physical address of the organization

URL to the organization logo

Example:

"https://example.com/logo.png"

​
nteeCode
string | null
required

NTEE (National Taxonomy of Exempt Entities) code

Example:

"M20"

​
nteeDescription
string | null
required

Human-readable description of the NTEE code

Example:

"Disaster Preparedness and Relief Services"

​
featuredIndex
number
required

Priority index for featured organizations (higher = shows first)

Example:

1

​
isCompliant
boolean
required

Whether the organization is compliant with Endaoment requirements

Example:

true

​
lifetimeContributionsUsdc
string
required

Total lifetime contributions made to this organization in USDC

Example:

"1000000000"

​
donationsReceived
number
required

Total number of donations received by this organization

Example:

42

​
grantsReceived
number
required

Total number of grants received by this organization

Example:

15

Was this page helpful?

Raise issue