Skip to main content
GET
/
v2
/
orgs
/
search
Search organizations
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,
    "deployments": [
      {
        "chainId": 1,
        "contractAddress": "0x1234567890123456789012345678901234567890",
        "usdcBalance": "2000000",
        "isDeployed": true
      }
    ],
    "claimedDateUtc": "2024-03-20T10:30:00Z",
    "claimedType": "DIRECT",
    "claimed": true,
    "contactInfo": {
      "email": "[email protected]",
      "name": "John Doe",
      "phone": "+1 (555) 123-4567",
      "title": "Executive Director"
    },
    "website": "https://www.redcross.org"
  }
]

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
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

logo
string | null
required

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"

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

deployments
object[]
required

List of smart contract deployments across different chains. Includes all supported chains, even if the org is not deployed on them.

claimedDateUtc
object
required

UTC timestamp when the organization was claimed

Example:

"2024-03-20T10:30:00Z"

claimedType
enum<string> | null
required

Type of organization claim

Available options:
WalletClaim,
WireClaim
Example:

"DIRECT"

claimed
boolean
required

Whether the organization has been claimed

Example:

true

contactInfo
object
required

Contact information for the organization

website
string | null
required

Website URL of the organization

Example:

"https://www.redcross.org"