Updated

Nonprofits

Most U.S. nonprofits exist in the CHANGE platform. Each nonprofit has a CHANGE-issued ID; these IDs are used to reference nonprofits throughout our APIs. You can search for nonprofits manually on the dashboard, or you can seach programmatically.

Show a nonprofit

get /api/v1/nonprofits/{id}

Retrieves information for a nonprofit.

Parameters

id string REQUIRED

The id of a nonprofit from the CHANGE network.

Request

curl https://api.getchange.io/api/v1/nonprofits/n_MUjmT5yhdf4smx1ykRwO2ovt \
-u YOUR_PUBLIC_KEY:YOUR_SECRET_KEY

Response

{
"icon_url": "https://nonprofit-icons.s3-us-west-1.amazonaws.com/T.png",
"id": "n_MUjmT5yhdf4smx1ykRwO2ovt",
"name": "ONE TREE PLANTED",
"ein": "464664562",
"memo": null,
"address_line": "145 PINE HAVEN SHORES RD",
"city": "SHELBURNE",
"classification": "T22",
"mission": "Planting trees in areas that need support.",
"state": "VT",
"website": "WWW.ONETREEPLANTED.ORG",
"zip_code": "05482-7703"
}

Search a nonprofit

get /api/v1/nonprofits

Retrieves a list of nonprofits whose names match the provided name. This endpoint is paginated.

Parameters

name string

A string to search.

page number

The page to return. This endpoint is paginated, and returns up to 30 nonprofits at a time.

Request

curl https://api.getchange.io/api/v1/nonprofits \
-u YOUR_PUBLIC_KEY:YOUR_SECRET_KEY \
-d 'name=watsi&page=1' \
-G

Response

{
"nonprofits": [
{
"id": "n_IfEoPCaPqVsFAUI5xl0CBUOx",
"name": "WATSI",
"ein": "453236734",
"memo": null,
"last_verified_at": null,
"mission": "Directly connecting people through technology to provide global access to healthcare.",
"address_line": "548 Market St # 75903",
"state": "CA",
"city": "San Francisco",
"zip_code": "94104",
"website": "https://watsi.org/",
"classification": "E12",
"icon_url": "https://nonprofit-icons.s3-us-west-1.amazonaws.com/E.png"
}
],
"page": 1
}

Get social media content

get /api/v1/nonprofits/{id}/social_media_content

Retrieves social media content for the given nonprofit. This endpoint is not authenticated; pass your account's public key as a parameter instead.

Parameters

id string REQUIRED

The id of a nonprofit from the CHANGE network.

public_key string REQUIRED

Your account's public key.

Request

curl https://api.getchange.io/api/v1/nonprofits/n_IfEoPCaPqVsFAUI5xl0CBUOx/social_media_content \
-d 'public_key=YOUR_PUBLIC_KEY' \
-G

Response

[
{
"theme": "pink",
"url": "https://generated-social-media-content--production.s3.us-west-1.amazonaws.com/bc470139f3db7120b2e5de99507e2418.jpg"
},
{
"theme": "white",
"url": "https://generated-social-media-content--production.s3.us-west-1.amazonaws.com/c4f1280a75c890ec697dcda0225ad33d.jpg"
},
{
"theme": "black",
"url": "https://generated-social-media-content--production.s3.us-west-1.amazonaws.com/340ed7919e61062605e5a8f9b330e57a.jpg"
}
]
Made with ❤ in San Francisco