Skip to main content
GET
Search Nonprofits

Authorizations

X-API-Key
string
header
required

Add a header [X-API-Key] with the token

Headers

x-session-id
string<uuid>

A unique UUID value to maintain context

Query Parameters

q
string | null

Primary query used for the search

Maximum string length: 256
subsection_codes
string[] | null

List of 2-character numeric subsection codes (e.g., '03' indicates a 501C3, '04' indicates a 501C4)

Required string length: 2
Pattern: ^\d{2}$
foundation
boolean | null

Flag to filter by foundation status. If true, only foundations are included, and excluded if false.

deductible_donations
boolean | null

Flag to limit the search to organizations with deductible donations

latitude
number | null

Latitude for location-based search

longitude
number | null

Longitude for location-based search

location_range
number | null

Search radius in miles (0 for unlimited)

Required range: x >= 0
city
string | null

City for location-based search

Required string length: 2 - 100
county
string | null

County for location-based search

Required string length: 2 - 100
state
string | null

State for location-based search (2 character abbreviation)

Required string length: 2
zip_code
string | null

ZIP Code for location-based search

Pattern: ^\d{5}$
min_revenue
integer | null

Minimum annual revenue in dollars

Required range: x >= 0
max_revenue
integer | null

Maximum annual revenue in dollars

Required range: x >= 0
min_expenses
integer | null

Minimum annual expenses in dollars

Required range: x >= 0
max_expenses
integer | null

Maximum annual expenses in dollars

Required range: x >= 0
min_assets
integer | null

Minimum total assets in dollars

Required range: x >= 0
max_assets
integer | null

Maximum total assets in dollars

Required range: x >= 0
sdgs
integer[] | null

List of SDG numbers to filter by

Required range: 1 <= x <= 17
ntee_codes
string[] | null

List of NTEE (National Taxonomy of Exempt Entities) codes

min_employees
integer | null

Minimum number of employees

Required range: x >= 0
max_employees
integer | null

Maximum number of employees

Required range: x >= 0
min_score
integer | null

Minimum organization score

Required range: 0 <= x <= 100
max_score
integer | null

Maximum organization score

Required range: 0 <= x <= 100
min_rating
integer | null

Minimum star rating for organization

Required range: 0 <= x <= 4
max_rating
integer | null

Maximum star rating for organization

Required range: 0 <= x <= 4
org_size
string[] | null

One or more sizes of the organization based on classification. Valid values are 'Small', 'Medium', 'Large', and 'Super-Size'.

sort
string[] | null

Sort options for the search results.

max_vector_distance
number | null

Max vector distance for the search. Higher number means more lenient vector matching.

Required range: 0 <= x <= 1
model
string | null
default:gemini-2.5-flash-lite

LLM model to use for intent processing. Options: 'gemini-2.5-flash-lite' (default) or 'gpt-3.5-turbo-0125'.

page
integer
default:1

Page number

Required range: x >= 1
size
integer
default:10

Items per page

Required range: 1 <= x <= 100

Response

Successful Response

intentDetails
BetaChatIntentResponse · object | null

Response model for chat intents in the insights beta endpoint - Based off ChatIntentResponse

nonprofits
BetaNonprofitDetailsResponse · object[] | null