Sign in

v1

latestOpenAPI 3.0.12026-07-2427125325.2 KB

/essentials/v2

Find nonprofits using variable search criteria and explore essential information.

post/v2

Request body

search_termsstring

Can be any string you'd like to search on, including EIN, organization name, keywords, etc.

frominteger

The offset from the first result. Defaults to 0.

sizeinteger

The maximum number of hits to be returned. Defaults to 25. The maximum number allowed is 25.

Example request

{
  "search_terms": "candid",
  "size": 25,
  "sort": {
    "sort_by": "organization_name",
    "ascending": true
  },
  "filters": {
    "geography": {
      "state": [
        "NY"
      ],
      "radius": 50,
      "msa": [
        "NY-NJ"
      ],
      "city": [
        "New York"
      ],
      "county": [
        "New York, NY"
      ]
    },
    "organization": {
      "profile_levels": [
        "platinum"
      ],
      "ntee_major_codes": [
        "T"
      ],
      "ntee_minor_codes": [
        "50"
      ],
      "subsection_codes": [
        "501(c)(3) Public Charity"
      ],
      "foundation_codes": [
        "15"
      ],
      "bmf_status": true,
      "pub78_verified": true,
      "affiliation_type": {
        "independent": true
      },
      "number_of_employees_range": {
        "min": 5,
        "max": 987654321
      },
      "form_types": {
        "f990": true
      }
    },
    "financials": {
      "total_revenue": {
        "min": 5,
        "max": 987654321
      },
      "total_expenses": {
        "min": 5,
        "max": 987654321
      },
      "total_assets": {
        "min": 5,
        "max": 987654321
      }
    }
  }
}

Response

OK

codeinteger

Response Code

messagestring

Diagnostic message for response status

tookinteger

Time taken for request to process

errorsstring[]

List of errors encountered

Example response

{
  "code": 200,
  "message": "Request was processed successfully!",
  "took": 24,
  "data": {
    "took": 22,
    "total_hits": 1,
    "hits": [
      {
        "organization_id": "9938979",
        "ein": "82-4267025",
        "organization_name": "Illinois Youth Rugby Association",
        "also_known_as": "chillicothe rugby football club",
        "mission": "To assist those in need",
        "address_line_1": "123 West 1st Street",
        "address_line_2": "Suite 201",
        "city": "Chicago",
        "state": "IL",
        "zip": "23185",
        "county": "Peoria, IL",
        "msa": "IL - Peoria-Pekin",
        "lat_long": "40.9052,-89.5866",
        "ntee_code": "N60 Amateur Sports Clubs, Leagues, N.E.C.",
        "profile_level": "bronze",
        "public_report": "https://www.guidestar.org/profile/82-4267025",
        "subsection_code": "501(c)(3) Public Charity",
        "number_of_employees": "55",
        "form_type": "990",
        "website_url": "candid.org",
        "logo_url": "candid.org",
        "foundation_code": "15",
        "parent_orgs": "Parent Org, Parent Org 2",
        "bmf_gross_receipts": "2349999",
        "bmf_assets": "1849900",
        "form990_total_revenue": "2349999",
        "form990_total_expenses": "22224499",
        "form990_total_assets": "12348855",
        "contact_email": "help@orgname.org",
        "contact_name": "John Smith",
        "contact_phone": "(555) 111-5555",
        "contact_title": "Support Lead",
        "properties": {
          "parent": true,
          "national_hq": true,
          "audit_a133_performed": true,
          "bmf_status": true,
          "pub78_verified": true,
          "allow_online_giving": true
        }
      }
    ]
  }
}