API Reference

Donations

To create a donation, use the /api/v1/donations endpoint. In the response, you'll get a donation ID, which you can use to retrieve information about your donation.

Donation object

amount integer

The amount of the donation in cents.

id string

The ID of the donation.

live_mode boolean

Whether the donation was created with production (live) or sandbox (test) credentials.

nonprofit_id string

The ID of a nonprofit from the Change network.

order_value integer

Cart or order volume (in cents) associated with the donation. Change provides AOV metrics if order values are provided.

zip_code string

A zip code to associate with the donation. Change provides geography-based analytics if zip codes are provided.

external_id string

An external ID associated with the donation.

metadata object

Arbitrary metadata to be stored with the donation. Must be a valid JSON object.

currency string

The currency of the donation.

status enum
Possible values: pledged , invoice_sent , invoice_pending , payout_scheduled , sent_via_ach , sent_via_check , check_cashed , notified , canceled , blocked

The status of the donation.

Example

{
  "amount": 500,
  "id": "d_W5CMj0BBpv5pule6Ach3pScr",
  "live_mode": true,
  "nonprofit_id": "n_IfEoPCaPqVsFAUI5xl0CBUOx",
  "order_value": 2599,
  "zip_code": "94104",
  "external_id": "customer_1234",
  "metadata": {
    "order-number": "90210"
  },
  "currency": "USD",
  "status": "pledged"
}

Create a donation

post /api/v1/donations

Creates a donation to any nonprofit. Change keeps track of your donations, bills you at the end of the month, and handles the nonprofit payouts for you.

Parameters

amount number REQUIRED

The amount of the donation in cents.

nonprofit_id string REQUIRED

The id of a nonprofit from the Change network.

funds_collected boolean REQUIRED

Whether you are collecting payment for the donation. This helps us issue the correct tax receipt at the end of the year.

count number

The number of donations to submit.

cover_fees boolean

Whether the amount parameter should include processing fees. Default is false.

external_id string

An external ID associated with the donation, e.g. an order ID, SKU, or customer ID.

order_value number

Cart or order volume (in cents) associated with the donation. Change provides AOV metrics if order values are provided.

zip_code string

A zip code to associate with the donation. Change provides geography-based analytics if zip codes are provided.

metadata object

Arbitrary metadata to be stored with the donation. Must be a valid JSON object.

campaign_name string

Name of the campaign the donor is making the donation from.

Request 

curl https://api.getchange.io/api/v1/donations \
  -u YOUR_PUBLIC_KEY:YOUR_SECRET_KEY \
  -H "Content-Type: application/json" \
  -d '{
        "amount": 500,
        "nonprofit_id": "n_IfEoPCaPqVsFAUI5xl0CBUOx",
        "funds_collected": false,
        "external_id": "customer_1234",
        "order_value": 2599,
        "zip_code": "94104",
        "metadata": {
          "order-number": "90210"
        },
        "campaign_name": "John Doe"
      }'

Response

{
  "amount": 500,
  "id": "d_ijJALwHpbJmspfQ4bPJfELqs",
  "live_mode": true,
  "nonprofit_id": "n_IfEoPCaPqVsFAUI5xl0CBUOx",
  "order_value": 2599,
  "zip_code": "94104",
  "metadata": {
    "order-number": "90210"
  },
  "currency": "USD",
  "status": "pledged",
  "external_id": "customer_1234"
}

List your donations

get /api/v1/donations

Retrieves a list of donations you've previously made. The donations are returned in order of creation, with the most recent donations appearing first. This endpoint is paginated.

Parameters

page number

Which page to return. This endpoint is paginated, and returns maximum 30 donations per page.

nonprofit_id string

The id of a nonprofit from the Change network.

external_id string

An external ID associated with the donation, e.g. an order ID, SKU, or customer ID. This field is set when a donation is created.

start_timestamp number

Starting timestamp of donations being retrieved. Send as a unix timestamp.

end_timestamp number

Ending timestamp of donations being retrieved. Send as a unix timestamp.

Request 

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

Response

{
  "donations": [
    {
      "amount": 1000,
      "id": "d_yEUDGfW5GFHT19kmsxttbbR7",
      "live_mode": true,
      "nonprofit_id": "n_IfEoPCaPqVsFAUI5xl0CBUOx",
      "order_value": 3547,
      "zip_code": "26396",
      "metadata": {
        "key": "value"
      },
      "currency": "USD",
      "status": "pledged",
      "external_id": null
    },
    {
      "amount": 500,
      "id": "d_cNmomJNEjw4om0MJbAiMNnh4",
      "live_mode": true,
      "nonprofit_id": "n_nIstMceV5IXNWwMOzomgHEEV",
      "order_value": 1868,
      "zip_code": "21091-8133",
      "metadata": {
        "key": "value"
      },
      "currency": "USD",
      "status": "pledged",
      "external_id": null
    }
  ],
  "page": 1
}

Retrieve a donation

get /api/v1/donations/{id}

Retrieves the details of a donation you've previously made.

Parameters

id string (in path) REQUIRED

The id of a donation. Ids are returned when a donation is created.

Request 

curl https://api.getchange.io/api/v1/donations/d_cNmomJNEjw4om0MJbAiMNnh4 \
  -u YOUR_PUBLIC_KEY:YOUR_SECRET_KEY

Response

{
  "amount": 500,
  "id": "d_cNmomJNEjw4om0MJbAiMNnh4",
  "live_mode": true,
  "nonprofit_id": "n_MUjmT5yhdf4smx1ykRwO2ovt",
  "order_value": 4200,
  "zip_code": "96983",
  "metadata": {
    "key": "value"
  },
  "currency": "USD",
  "status": "pledged",
  "external_id": null
}

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. Missions may be enhanced by AI.

Parameters

id string (in path) 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

{
  "id": "n_MUjmT5yhdf4smx1ykRwO2ovt",
  "name": "One Tree Planted Inc",
  "ein": "464664562",
  "pending_payout_amount": 1500,
  "socials": {
    "facebook": "onetreeplanted",
    "instagram": "onetreeplanted",
    "twitter": "onetreeplanted",
    "youtube": "channel/UCSyNWLnxtob29DOoPGpT1Ug"
  },
  "email": "hello@onetreeplanted.org",
  "icon_url": "https://d2m0e1zy3fwxmp.cloudfront.net/public-benefit.png",
  "payable": true,
  "payability_restrictions": [],
  "pending_payout_amounts": {
    "USD": "1500.0"
  },
  "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",
  "category": "public benefit",
  "cover_image_url": null,
  "logo_url": null,
  "categories": [
    "Private Independent Foundations"
  ]
}

Search a nonprofit

get /api/v1/nonprofits

Retrieves a list of nonprofits that match the search parameters. Missions may be enhanced by AI. This endpoint is paginated.

Parameters

public_key string REQUIRED

Your account's public key.

search_term string

A string to search. This can be the name of a nonprofit, or an EIN. If you do not provide this parameter, you'll get featured nonprofits.

categories[] array

List of categories to search. Valid categories are: 'arts and culture', 'education', 'environment', 'animals', 'healthcare', 'human services', 'international affairs', 'public benefit', 'religion', 'mutual benefit', 'unclassified'.

page number

The page to return. This endpoint is paginated. Page can range between 1 and 100, and the default is 1.

limit number

A limit on the number of nonprofits to be returned. Limit can range between 1 and 200, and the default is 30.

show_hidden boolean

If true, the response will include hidden nonprofits, including unpayable ones.

Request 

curl https://api.getchange.io/api/v1/nonprofits \
  -d 'public_key=YOUR_PUBLIC_KEY&search_term=watsi&page=1&limit=10' \
  -G

Response

{
  "nonprofits": [
    {
      "id": "n_IfEoPCaPqVsFAUI5xl0CBUOx",
      "name": "Watsi",
      "ein": "453236734",
      "socials": {
        "facebook": "Watsi.org",
        "instagram": "watsi",
        "twitter": "watsi"
      },
      "email": "connect@watsi.org",
      "icon_url": "https://d2m0e1zy3fwxmp.cloudfront.net/healthcare.png",
      "payable": true,
      "payability_restrictions": [],
      "address_line": "548 Market St # 75903",
      "city": "San Francisco",
      "classification": "E12",
      "mission": "Directly connecting people through technology to provide global access to healthcare.",
      "state": "CA",
      "website": "https://watsi.org/",
      "zip_code": "94104",
      "category": "healthcare",
      "cover_image_url": null,
      "logo_url": null,
      "categories": [
        "Fund Raising & Fund Distribution"
      ],
      "stats": [
        "$100 sponsors 1 surgery"
      ]
    }
  ],
  "page": 1
}

Get social media content

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

Retrieves social media content for the given nonprofit. CHANGE generates ready-to-post, social-media optimized images that are customized with your company name. This endpoint is not authenticated; pass your account's public key as a parameter instead. Note that this endpoint does not post anything to social media.

Parameters

id string (in path) 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"
  }
]

Nonprofit Requests

If a nonprofit you like isn't in our system, you can request it. We'll review your request, and if everything checks out, we'll add it to our system.

Request a nonprofit

post /api/v1/nonprofit_requests

Requests a nonprofit.

Parameters

name string REQUIRED

The name of the nonprofit.

ein string REQUIRED

The EIN of the nonprofit.

address_line string

The address of the nonprofit.

city string

The city the nonprofit is in.

state string

The state the nonprofit is in.

classification string

The NTEE code for the nonprofit.

mission string

The mission of the nonprofit.

socials object

The social handles of the nonprofit. Accepted keys are: facebook, instagram, tiktok, twitter, youtube.

website string

The website of the nonprofit.

admin_email string

A contact email for the nonprofit.

payout_email string

An email address to use for the nonprofit's payouts.

image_url string

The URL of an image that represents the nonprofit.

Request 

curl https://api.getchange.io/api/v1/nonprofit_requests \
  -u YOUR_PUBLIC_KEY:YOUR_SECRET_KEY \
  -H "Content-Type: application/json" \
  -d '{
        "name": "Do Good",
        "ein": "123-45678",
        "address_line": "123 Charity Ln",
        "city": "San Francisco",
        "state": "CA",
        "classification": "N12",
        "mission": "To do more good.",
        "socials": {
          "twitter": "dogooderz"
        },
        "website": "dogood.org"
      }'

Response

{
  "result": {
    "address_line": "123 Charity Ln",
    "city": "San Francisco",
    "classification": "N12",
    "admin_email": null,
    "ein": "123-45678",
    "image_url": null,
    "mission": "To do more good.",
    "name": "Do Good",
    "payout_email": null,
    "socials": {
      "twitter": "dogooderz"
    },
    "status": "pending",
    "website": "dogood.org",
    "id": "nr_7NhQRmg3CM8bpHDV1CaYgWss"
  }
}

List your nonprofit requests

get /api/v1/nonprofit_requests

Retrieves your nonprofit requests. Check the status field for the current status of the request. For accepted requests, the nonprofit_id field will be populated with your requested nonprofit's Change ID.

Parameters

There are no parameters.

Request 

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

Response

{
  "result": [
    {
      "address_line": "123 Charity Ln",
      "city": "San Francisco",
      "classification": "N12",
      "admin_email": "tobias.mante@huels.biz",
      "ein": "123-45678",
      "image_url": null,
      "mission": "To do more good.",
      "name": "Do Good",
      "payout_email": null,
      "socials": {
        "twitter": "dogooderz"
      },
      "status": "pending",
      "website": "dogood.org",
      "id": "nr_c7B3EGlwdYWDbJJ7uQWTqHK3"
    }
  ]
}

Show a nonprofit request

get /api/v1/nonprofit_requests/{id}

Retrieves a nonprofit request. Check the status field for the current status of the request. For accepted requests, the nonprofit_id field will be populated with your requested nonprofit's Change ID.

Parameters

id string (in path) REQUIRED

The id of a nonprofit request.

Request 

curl https://api.getchange.io/api/v1/nonprofit_requests/nr_2Znf2stcvgIWgIaF5nF88Xth \
  -u YOUR_PUBLIC_KEY:YOUR_SECRET_KEY

Response

{
  "result": {
    "address_line": "123 Charity Ln",
    "city": "San Francisco",
    "classification": "N12",
    "admin_email": "kiyoko@adams.net",
    "ein": "123-45678",
    "image_url": null,
    "mission": "To do more good.",
    "name": "Do Good",
    "payout_email": null,
    "socials": {
      "twitter": "dogooderz"
    },
    "status": "pending",
    "website": "dogood.org",
    "id": "nr_2Znf2stcvgIWgIaF5nF88Xth"
  }
}

Transfers

(Ask us for access) If you use Stripe to collect payments, you can make donations by transferring Stripe funds directly to Change.

Capture a Stripe Transfer

post /api/v1/transfers

(Ask us for access) Creates a donation from an existing Stripe Transfer. A successful response will be empty with a status of 200.

Parameters

nonprofit_id string REQUIRED

The ID of a nonprofit from the Change network.

stripe_destination_payment_id string REQUIRED

The destination payment ID of a Stripe Transfer. You can find this ID in the response from Stripe when creating a Stripe Transfer, or when capturing a Stripe PaymentIntent containing transfer_data.

external_id string

An external ID associated with the donation, e.g. an order ID, SKU, or customer ID.

Request 

curl https://api.getchange.io/api/v1/transfers \
  -u YOUR_PUBLIC_KEY:YOUR_SECRET_KEY \
  -H "Content-Type: application/json" \
  -d '{
        "nonprofit_id": "n_IfEoPCaPqVsFAUI5xl0CBUOx",
        "stripe_destination_payment_id": "py_00000000000000000000000",
        "external_id": "customer_1234"
      }'

Response

{
  "amount": 101,
  "fee": 3,
  "stripe_application_fee": 0,
  "nonprofit_id": "n_IfEoPCaPqVsFAUI5xl0CBUOx",
  "external_id": "customer_1234"
}

Reports

See the impact you've made with the Reports API. Generate reports that summarize your giving in relatable terms.

Fetch impact report

get /api/v1/reports/impact

Fetches a report detailing the aggregated impact of your donations.

Parameters

account_id string

An account id to filter donations that are included in the report. Leave this blank to include all donations made by you or your managed accounts.

external_id string

An external id to filter donations that are included in the report.

start_timestamp number

Starting timestamp of data to be included in the report. Send as a unix timestamp.

end_timestamp number

Ending timestamp of data to be included in the report. Send as a unix timestamp.

Request 

curl https://api.getchange.io/api/v1/reports/impact \
  -u YOUR_PUBLIC_KEY:YOUR_SECRET_KEY

Response

{
  "data": [
    {
      "id": "n_MUjmT5yhdf4smx1ykRwO2ovt",
      "name": "One Tree Planted Inc",
      "ein": "464664562",
      "socials": {
        "facebook": "onetreeplanted",
        "instagram": "onetreeplanted",
        "twitter": "onetreeplanted",
        "youtube": "channel/UCSyNWLnxtob29DOoPGpT1Ug"
      },
      "email": "hello@onetreeplanted.org",
      "icon_url": "https://d2m0e1zy3fwxmp.cloudfront.net/public-benefit.png",
      "payable": true,
      "payability_restrictions": [],
      "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",
      "category": "public benefit",
      "cover_image_url": null,
      "logo_url": null,
      "categories": [
        "Private Independent Foundations"
      ],
      "total_impact": [
        "planted 327 trees"
      ]
    },
    {
      "id": "n_nIstMceV5IXNWwMOzomgHEEV",
      "name": "Aim For Mental Health Inc",
      "ein": "473992060",
      "socials": {
        "facebook": "AIMforMentalHealth",
        "instagram": "aimmentalhealth",
        "twitter": "AimMentalHealth",
        "youtube": "channel/AimMentalHealth"
      },
      "email": null,
      "icon_url": "https://d2m0e1zy3fwxmp.cloudfront.net/healthcare.png",
      "payable": true,
      "payability_restrictions": [],
      "address_line": "PO BOX 4235",
      "city": "CARMEL",
      "classification": "F32",
      "mission": "WE FIND AND FUND THE MOST PROMISING YOUTH MENTAL HEALTH RESEARCH IN THE WORLD SO WE CAN FIND REAL SOLUTIONS WITH IMMEDIATE IMPACTS. WE RAISE AWARENESS WITHIN OUR COMMUNITIES REGARDING THE MENTAL HEALTH CRISIS AMONG OUR YOUTH.",
      "state": "CA",
      "website": "WWW.AIMFORMENTALHEALTH.ORG",
      "zip_code": "93921-4235",
      "category": "healthcare",
      "cover_image_url": null,
      "logo_url": null,
      "categories": [
        "Community Mental Health Centers"
      ],
      "total_impact": [
        "sponsored therapy sessions",
        "sponsored books for children",
        "purchased pencils for test takers in need",
        "sponsored trips to San Francisco"
      ]
    }
  ],
  "filters": {
    "end_timestamp": 1757529684
  }
}

Prebuilt Pages

Our prebuilt pages allow you to easily accept donations without integrating a payment processor.

post /api/v1/payments/checkout_link

Creates a Stripe Checkout link to collect donations for a specific nonprofit. Donation processing fees are automatically deducted from the collected amount.

Parameters

amount number REQUIRED

The amount of the donation in cents.

cancel_url string REQUIRED

The url the donor will be redirected to if they cancel checkout. Must be prefixed with https://

nonprofit_id string REQUIRED

The id of a nonprofit from the Change network.

success_url string REQUIRED

The url the donor will be redirected to upon a successful donation. Must be prefixed with https://

external_id string

An external ID associated with the donation, e.g. an order ID, SKU, or customer ID. Will be attached to the donation created by a successful checkout.

metadata object

Arbitrary metadata to be stored with the donation. Must be a valid JSON object. Will be attached to the donation created by a successful checkout.

Request 

curl https://api.getchange.io/api/v1/payments/checkout_link \
  -u YOUR_PUBLIC_KEY:YOUR_SECRET_KEY \
  -H "Content-Type: application/json" \
  -d '{
        "amount": 500,
        "cancel_url": "https://your-domain.com/cancel",
        "nonprofit_id": "n_IfEoPCaPqVsFAUI5xl0CBUOx",
        "success_url": "https://your-domain.com/success",
        "external_id": "customer_1234"
      }'

Response

{
  "checkout_url": "https://checkout.stripe.com/pay/cs_123"
}

Nonprofit Filing Data

API endpoints to assist with nonprofit renewal filing.

Create or update nonprofit filing data

post /api/v1/nonprofit_filing_data/{ein}

Creates or updates nonprofit filing data.

Parameters

ein string (in path) REQUIRED

The EIN of the nonprofit.

nonprofit_filing_data object

See the NonprofitFilingData object for a full description of all fields allowed by this endpoint.

Request 

curl https://api.getchange.io/api/v1/nonprofit_filing_data/464664562 \
  -u YOUR_PUBLIC_KEY:YOUR_SECRET_KEY \
  -H "Content-Type: application/json" \
  -d '{
        "organization_name": "Test Nonprofit"
      }'

Response

{
  "data": {
    "law_firm_name": "Traversi & Taylor",
    "law_firm_contact_email": "admin@traversitaylor.com",
    "law_firm_contact_phone": "123-123-1234",
    "law_firm_contact_address": {
      "city": "San Francisco",
      "state": "CA",
      "county": "",
      "zip_code": "94105",
      "default_field": null,
      "address_line_1": "123 Main St",
      "address_line_2": ""
    },
    "law_firm_contact_last_name": "Doe",
    "law_firm_contact_first_name": "Jane",
    "fiscal_year_end_date": "2025-12-31",
    "dba": "DGF",
    "ein": "464664562",
    "fyb": "2024-01-01",
    "fye": "2024-12-31",
    "banks": [
      {
        "name": "Chase Bank",
        "address": {
          "city": "New York",
          "state": "NY",
          "county": "Big Apple",
          "zip_code": "10001",
          "default_field": null,
          "address_line_1": "444 4th St, New York NY 10002, Big Apple",
          "address_line_2": ""
        },
        "bank_phone": "999-999-9999",
        "bank_account_number": "99900000009"
      },
      {
        "name": "Wells Fargo",
        "address": {
          "city": "New York",
          "state": "NY",
          "county": "Big Apple",
          "zip_code": "10001",
          "default_field": null,
          "address_line_1": "123 WF St",
          "address_line_2": ""
        },
        "bank_phone": "333-333-3333",
        "bank_account_number": "33300000003"
      }
    ],
    "irc_date": "2001-06-02",
    "ntee_code": "X",
    "ohio_bingo": "true",
    "accountants": [
      {
        "name": "H&R Block",
        "address": {
          "city": "San Diego",
          "state": "CA",
          "county": "",
          "zip_code": "93789",
          "default_field": null,
          "address_line_1": "33e 3rd St",
          "address_line_2": ""
        }
      },
      {
        "name": "Johnson Baker",
        "address": {
          "city": "Honolulu",
          "state": "HI",
          "county": "",
          "zip_code": "99999",
          "default_field": null,
          "address_line_1": "505 Main St",
          "address_line_2": ""
        }
      }
    ],
    "percent_fund": "4",
    "auditor_title": "CPA",
    "board_members": [
      {
        "email": "name1@dogoodfoundation.org",
        "hours": "40",
        "phone": {
          "value": "555-555-5555",
          "default_field": null
        },
        "title": "Title 1",
        "salary": "100000",
        "address": {
          "city": "Suite 1000",
          "state": "CA",
          "county": "SF",
          "zip_code": "12345",
          "default_field": "nonprofit_address",
          "address_line_1": "123 Main St",
          "address_line_2": "San Francisco"
        },
        "last_name": "Last name 1",
        "first_name": "First name 1",
        "middle_name": "",
        "responsible_for_custody_of": "custody_of_funds,custody_of_records"
      },
      {
        "email": "name2@dogoodfoundation.org",
        "hours": "40",
        "phone": {
          "value": "123-456-7890",
          "default_field": "nonprofit_phone"
        },
        "title": "Title 2",
        "salary": "85000",
        "address": {
          "city": "Suite 1000",
          "state": "CA",
          "county": "SF",
          "zip_code": "12345",
          "default_field": "nonprofit_address",
          "address_line_1": "123 Main St",
          "address_line_2": "San Francisco"
        },
        "last_name": "Last name 2",
        "first_name": "First name 2",
        "middle_name": "",
        "responsible_for_custody_of": "responsible_for_fundraising,responsible_for_distribution_of_funds,responsible_for_signing_checks"
      }
    ],
    "nonprofit_fax": "123-456-7890",
    "oregon_assets": "99999",
    "assets_in_ohio": "true",
    "oregon_revenue": "9999999",
    "tax_deductible": "true",
    "by_laws_updated": "true",
    "irs_application": "true",
    "new_york_assets": "800000",
    "new_york_office": "true",
    "nonprofit_email": "example@dogoodfoundation.org",
    "nonprofit_phone": "123-456-7890",
    "signatory_email": "signer@dogoodfoundation.org",
    "signatory_title": "Executive Director",
    "cease_and_desist": "false",
    "date_established": "2001-01-20",
    "services_in_ohio": "true",
    "auditor_last_name": "Example",
    "dbas_with_florida": "",
    "denied_or_revoked": "false",
    "enjoined_by_court": "false",
    "government_grants": [
      {
        "name": "Fed Grant #1",
        "agency": "USAID",
        "amount": "100000"
      },
      {
        "name": "Fed Grant #2",
        "agency": "USAID",
        "amount": "2904389"
      }
    ],
    "nonprofit_address": {
      "city": "Suite 1000",
      "state": "CA",
      "county": "SF",
      "zip_code": "12345",
      "default_field": null,
      "address_line_1": "123 Main St",
      "address_line_2": "San Francisco"
    },
    "nonprofit_purpose": "Our mission is to create an inclusive and nurturing community",
    "nonprofit_website": "dogoodfoundation.org",
    "organization_name": "Test Nonprofit",
    "organization_type": "corporation",
    "auditor_first_name": "John",
    "california_raffles": "true",
    "convicted_of_crime": "false",
    "disposed_of_assets": "true",
    "irs_letter_updated": "true",
    "ohio_contributions": "50000",
    "ohio_distributions": "40000",
    "ohio_entity_number": "0510",
    "california_lobbying": "true",
    "city_established_in": "San Francisco",
    "convicted_of_felony": "false",
    "diversion_of_assets": "true",
    "federated_nonprofit": "true",
    "fundraising_methods": "corporate_solicitation,door_to_door,email,mail,online_marketing,phone",
    "ohio_board_meetings": "7",
    "signatory_last_name": "Doe",
    "bingo_license_number": "31460",
    "irs_application_date": "2001-01-01",
    "north_dakota_revenue": "30000",
    "percent_fund_managed": "9",
    "signatory_first_name": "Jane",
    "state_established_in": "CA",
    "states_registered_in": "AL,AK,AS,AR,CA,CO,CT,DE,DC,FL,GA,GU,HI,ID,IL,IN,IA,KS,KY,LA,ME,MD,MA,MI,MN,MS,MO,MT,NE,NV,NH,NJ,NM,NY,NC,ND,MP,OH,OK,OR,PA,PR,RI,SC,SD,TN,TX,TT,UT,VT,VI,VA,WA,WV,WI,WY",
    "irs_tax_exempt_status": "501(c)(3)",
    "loans_with_staff_ohio": "false",
    "misdemeanor_or_felony": "false",
    "signatory_middle_name": "",
    "subject_of_proceeding": "false",
    "commercial_co_ventures": "true",
    "new_york_contributions": "1234567",
    "north_dakota_disbursed": "20000",
    "second_signatory_email": "secondsigner@dogoodfoundation.org",
    "second_signatory_title": "CFO",
    "state_agency_agreement": "false",
    "california_car_donation": "true",
    "large_transactions_ohio": "false",
    "minnesota_contributions": "20394",
    "related_officers_vendor": "false",
    "subjected_to_proceeding": "true",
    "professional_fundraisers": "true",
    "tax_exempt_status_denied": "false",
    "financial_records_address": {
      "city": "Suite 1000",
      "state": "CA",
      "county": "SF",
      "zip_code": "12345",
      "default_field": "nonprofit_address",
      "address_line_1": "123 Main St",
      "address_line_2": "San Francisco"
    },
    "indebted_to_related_party": "false",
    "massachusetts_engage_date": "2001-07-23",
    "nonprofit_mailing_address": {
      "city": "Suite 1000",
      "state": "CA",
      "county": "SF",
      "zip_code": "12345",
      "default_field": "nonprofit_address",
      "address_line_1": "123 Main St",
      "address_line_2": "San Francisco"
    },
    "related_officers_internal": "true",
    "tax_exempt_status_revoked": "true",
    "transfer_to_related_party": "true",
    "articles_of_incorp_updated": "true",
    "california_raffles_details": "Raffle Details",
    "enjoined_by_court_employee": "false",
    "organization_contact_email": "contact@dogoodfoundation.org",
    "organization_contact_title": "Head of Impact",
    "receives_government_grants": "true",
    "second_signatory_last_name": "Doe",
    "sold_or_transferred_assets": "true",
    "solicitation_counties_ohio": "adams,allen,ashland,ashtabula,athens,auglaize",
    "tax_exempt_status_modified": "false",
    "washington_employees_names": [
      {
        "title": "Washington Title 3",
        "last_name": "Moneybags",
        "first_name": "Dr"
      },
      {
        "title": "Washington Title 1",
        "last_name": "Moneybags",
        "first_name": "Mr"
      },
      {
        "title": "Washington Title 2",
        "last_name": "Moneybags",
        "first_name": "Ms"
      }
    ],
    "california_lobbying_details": "Lobbying Details",
    "convicted_of_crime_employee": "true",
    "investment_in_related_party": "false",
    "paid_wages_to_related_party": "false",
    "related_officers_fundraiser": "false",
    "second_signatory_first_name": "John",
    "solicitation_not_year_round": "true",
    "west_virginia_contributions": "272727",
    "west_virginia_distributions": "4000",
    "agreement_with_related_party": "false",
    "chapters_branches_affiliates": [
      {
        "ein": "12-3456789",
        "type": "office",
        "state": "colorado",
        "address": {
          "city": "Boulder",
          "state": "CO",
          "county": "",
          "zip_code": "20002",
          "default_field": null,
          "address_line_1": "77 Rock St",
          "address_line_2": ""
        },
        "chapter_name": "",
        "chapter_phone": "258-234-5892",
        "contact_last_name": "Colorado",
        "contact_first_name": "Mr"
      },
      {
        "ein": "",
        "type": "chapter",
        "state": "ohio",
        "address": {
          "city": "Columbus",
          "state": "OH",
          "county": "",
          "zip_code": "65656",
          "default_field": null,
          "address_line_1": "88 Columbus Ave",
          "address_line_2": ""
        },
        "chapter_name": "",
        "chapter_phone": "234-234-2343",
        "contact_last_name": "Ohio",
        "contact_first_name": "Ms"
      }
    ],
    "convicted_of_felony_employee": "true",
    "second_signatory_middle_name": "",
    "applied_for_tax_exempt_status": "true",
    "donor_restricted_funds_loaned": "false",
    "disposed_of_assets_explanation": "oh test 1",
    "donor_restricted_funds_removed": "true",
    "nonprofit_programs_description": "We leads several charitable programs aimed at supporting the local community.",
    "organization_contact_last_name": "Doe",
    "tax_exempt_status_revoked_date": "1992-07-10",
    "california_car_donation_details": "Card Donation Details",
    "diversion_of_assets_explanation": "some explanation",
    "org_invested_in_corporate_stock": "false",
    "organization_contact_first_name": "Jane",
    "fundraising_agreements_last_year": [
      {
        "notes": "CCV Notes",
        "address": {
          "city": "Sacramento",
          "state": "CA",
          "county": "",
          "zip_code": "95758",
          "default_field": null,
          "address_line_1": "CCV St",
          "address_line_2": ""
        },
        "contract_type": "ccv",
        "payment_terms": "Terms 2",
        "states_included": "All",
        "amount_paid_to_fundraiser": "2000",
        "fundraising_activity_type": "Phone",
        "fundraising_agreement_name": "CCV Last Year",
        "fundraising_agreement_amount": "20000",
        "fundraising_agreement_end_date": "2025-07-29",
        "fundraising_agreement_start_date": "2025-07-22",
        "total_amount_paid_to_organization": "2001",
        "fundraising_agreement_signing_date": "2025-07-08",
        "gross_receipts_from_fundraising_activities": "2222000"
      },
      {
        "notes": "PFR Notes",
        "address": {
          "city": "Sacramento",
          "state": "CA",
          "county": "",
          "zip_code": "95758",
          "default_field": null,
          "address_line_1": "PFR St",
          "address_line_2": ""
        },
        "contract_type": "pfr",
        "payment_terms": "Terms 1",
        "states_included": "AL,AK,AS,AZ,AR,CA,CO,CT,DE,DC,FL,GA,GU,HI,ID,IL,IN,IA,KS,KY,LA,ME,MD,MA,MI,MN,MS,MO,MT,NE,NV,NH,NJ,NM,NY,NC,ND,MP,OH,OK,OR,PA,PR,RI,SC,SD,TN,TX,TT,UT,VT,VI,VA,WA,WV,WI,WY",
        "amount_paid_to_fundraiser": "1000",
        "fundraising_activity_type": "In-person",
        "fundraising_agreement_name": "PFR Last Year",
        "fundraising_agreement_amount": "100000",
        "fundraising_agreement_end_date": "2025-07-28",
        "fundraising_agreement_start_date": "2025-07-21",
        "total_amount_paid_to_organization": "1001",
        "fundraising_agreement_signing_date": "2025-07-07",
        "gross_receipts_from_fundraising_activities": "111111000"
      },
      {
        "notes": "PFRC notes",
        "address": {
          "city": "Sacramento",
          "state": "CA",
          "county": "",
          "zip_code": "95758",
          "default_field": null,
          "address_line_1": "PFRC St",
          "address_line_2": ""
        },
        "contract_type": "pfrc",
        "payment_terms": "Terms 3",
        "states_included": "AL,AK,AS,AZ,AR,CA,CO,CT,DE,DC,FL,GA,GU,HI,ID,IL,IN,IA,KS,KY,LA,ME,MD,MA,MI,MN,MS,MO,MT,NE,NV,NH,NJ,NM,NY,NC,ND,MP,OH,OK,OR,PA,PR,RI,SC,SD,TN,TX,TT,UT,VT,VI,VA,WA,WV,WI,WY",
        "amount_paid_to_fundraiser": "3000",
        "fundraising_activity_type": "E-marketing",
        "fundraising_agreement_name": "PFRC Last Year",
        "fundraising_agreement_amount": "300000",
        "fundraising_agreement_end_date": "2025-07-30",
        "fundraising_agreement_start_date": "2025-07-23",
        "total_amount_paid_to_organization": "3001",
        "fundraising_agreement_signing_date": "2025-07-09",
        "gross_receipts_from_fundraising_activities": "3333000"
      }
    ],
    "fundraising_agreements_this_year": [
      {
        "notes": "CCV Notes",
        "address": {
          "city": "Sacramento",
          "state": "CA",
          "county": "",
          "zip_code": "95758",
          "default_field": null,
          "address_line_1": "CCV St",
          "address_line_2": ""
        },
        "contract_type": "ccv",
        "payment_terms": "Terms 2",
        "states_included": "AL,AK,AS,AZ,AR,CA,CO,CT,DE,DC,FL,GA,GU,HI,ID,IL,IN,IA,KS,KY,LA,ME,MD,MA,MI,MN,MS,MO,MT,NE,NV,NH,NJ,NM,NY,NC,ND,MP,OH,OK,OR,PA,PR,RI,SC,SD,TN,TX,TT,UT,VT,VI,VA,WA,WV,WI,WY",
        "amount_paid_to_fundraiser": "77700",
        "fundraising_activity_type": "Phone",
        "fundraising_agreement_name": "CCV This Year",
        "fundraising_agreement_amount": "2222",
        "fundraising_agreement_end_date": "2025-07-21",
        "fundraising_agreement_start_date": "2025-07-14",
        "total_amount_paid_to_organization": "77701",
        "fundraising_agreement_signing_date": "2025-07-07",
        "gross_receipts_from_fundraising_activities": "565656"
      },
      {
        "notes": "PFR Notes",
        "address": {
          "city": "Sacramento",
          "state": "CA",
          "county": "",
          "zip_code": "95758",
          "default_field": null,
          "address_line_1": "PFR St",
          "address_line_2": ""
        },
        "contract_type": "pfr",
        "payment_terms": "Terms 1",
        "states_included": "AL,AK,AS,AZ,AR,CA,CO,CT,DE,DC,FL,GA,GU,HI,ID,IL,IN,IA,KS,KY,LA,ME,MD,MA,MI,MN,MS,MO,MT,NE,NV,NH,NJ,NM,NY,NC,ND,MP,OH,OK,OR,PA,PR,RI,SC,SD,TN,TX,TT,UT,VT,VI,VA,WA,WV,WI,WY",
        "amount_paid_to_fundraiser": "88800",
        "fundraising_activity_type": "In-person",
        "fundraising_agreement_name": "PFR This Year",
        "fundraising_agreement_amount": "11111",
        "fundraising_agreement_end_date": "2025-07-22",
        "fundraising_agreement_start_date": "2025-07-15",
        "total_amount_paid_to_organization": "88801",
        "fundraising_agreement_signing_date": "2025-07-08",
        "gross_receipts_from_fundraising_activities": "787878"
      },
      {
        "notes": "PFRC Notes",
        "address": {
          "city": "Sacramento",
          "state": "CA",
          "county": "",
          "zip_code": "95758",
          "default_field": null,
          "address_line_1": "PFRC St",
          "address_line_2": ""
        },
        "contract_type": "pfrc",
        "payment_terms": "Terms 3",
        "states_included": "AL,AK,AS,AZ,AR,CA,CO,CT,DE,DC,FL,GA,GU,HI,ID,IL,IN,IA,KS,KY,LA,ME,MD,MA,MI,MN,MS,MO,MT,NE,NV,NH,NJ,NM,NY,NC,ND,MP,OH,OK,OR,PA,PR,RI,SC,SD,TN,TX,TT,UT,VT,VI,VA,WA,WV,WI,WY",
        "amount_paid_to_fundraiser": "99900",
        "fundraising_activity_type": "E-marketing",
        "fundraising_agreement_name": "PFRC This Year",
        "fundraising_agreement_amount": "3333",
        "fundraising_agreement_end_date": "2025-07-23",
        "fundraising_agreement_start_date": "2025-07-16",
        "total_amount_paid_to_organization": "99901",
        "fundraising_agreement_signing_date": "2025-07-09",
        "gross_receipts_from_fundraising_activities": "454545"
      }
    ],
    "furnished_goods_to_related_party": "false",
    "irs_determination_effective_date": "1990-07-09",
    "organization_contact_middle_name": "",
    "professional_fundraising_counsel": "true",
    "org_make_grant_award_contribution": "false",
    "solicitation_contract_unfulfilled": "",
    "authorized_by_other_authority_ohio": "true",
    "professional_solicitation_services": "true",
    "unlawful_practices_final_judgement": "false",
    "acquired_goods_from_RP_compensation": "false",
    "compensated_members_for_fundraising": "true",
    "property_held_in_name_of_person_org": "false",
    "subjected_to_proceeding_explanation": "some explanation",
    "transferred_income_to_for_use_by_RP": "false",
    "financial_transactions_with_interest": "true",
    "related_officers_internal_explanation": "some explanation",
    "solicitation_not_in_all_counties_ohio": "true",
    "transfer_to_related_party_explanation": "some explanation",
    "leased_assets_to_or_from_related_party": "false",
    "mississippi_board_member_contact_email": "drew@ststephens.org",
    "mississippi_board_member_contact_phone": "888-800-8000",
    "mississippi_board_member_contact_title": "Head of Mississippi Relations",
    "sold_or_transferred_assets_explanation": "some explanation",
    "convicted_of_crime_employee_explanation": "some explanation",
    "org_party_to_transaction_w_fin_interest": "false",
    "solicitation_not_year_round_explanation": "Jun 1 - Jun 30",
    "convicted_of_felony_employee_explanation": "some explanation",
    "mississippi_board_member_contact_2_email": "steve@dogoodfoundation.org",
    "mississippi_board_member_contact_2_phone": "222-200-2000",
    "mississippi_board_member_contact_2_title": "Head of Mississippi Programs",
    "mississippi_board_member_contact_address": {
      "city": "Yazoo City",
      "state": "MS",
      "county": "",
      "zip_code": "33333",
      "default_field": null,
      "address_line_1": "333 River Road",
      "address_line_2": ""
    },
    "tax_exempt_status_denied_revoked_modified": "true",
    "donor_restricted_funds_removed_explanation": "Mass test 1",
    "mississippi_board_member_contact_2_address": {
      "city": "Buloxi",
      "state": "MS",
      "county": "",
      "zip_code": "33332",
      "default_field": null,
      "address_line_1": "444 Delta Circle",
      "address_line_2": ""
    },
    "mississippi_board_member_contact_last_name": "Doe",
    "mississippi_board_member_contact_first_name": "Jane",
    "mississippi_board_member_contact_2_last_name": "Doe",
    "mississippi_board_member_contact_middle_name": "",
    "mississippi_board_member_contact_2_first_name": "Steve",
    "authorized_by_other_authority_ohio_explanation": "some explanation",
    "mississippi_board_member_contact_2_middle_name": "",
    "financial_transactions_with_interest_explanation": "some explanation"
  },
  "errors": []
}

Retrieve nonprofit filing data

get /api/v1/nonprofit_filing_data/{ein}

Retrieves the nonprofit filing data.

Parameters

ein string (in path) REQUIRED

The EIN of the nonprofit.

Request 

curl https://api.getchange.io/api/v1/nonprofit_filing_data/464664562 \
  -u YOUR_PUBLIC_KEY:YOUR_SECRET_KEY

Response

{
  "data": {
    "law_firm_name": "Traversi & Taylor",
    "law_firm_contact_email": "admin@traversitaylor.com",
    "law_firm_contact_phone": "123-123-1234",
    "law_firm_contact_address": {
      "city": "San Francisco",
      "state": "CA",
      "county": "",
      "zip_code": "94105",
      "default_field": null,
      "address_line_1": "123 Main St",
      "address_line_2": ""
    },
    "law_firm_contact_last_name": "Doe",
    "law_firm_contact_first_name": "Jane",
    "fiscal_year_end_date": "2025-12-31",
    "dba": "DGF",
    "ein": "12-3456789",
    "fyb": "2024-01-01",
    "fye": "2024-12-31",
    "banks": [
      {
        "name": "Chase Bank",
        "address": {
          "city": "New York",
          "state": "NY",
          "county": "Big Apple",
          "zip_code": "10001",
          "default_field": null,
          "address_line_1": "444 4th St, New York NY 10002, Big Apple",
          "address_line_2": ""
        },
        "bank_phone": "999-999-9999",
        "bank_account_number": "99900000009"
      },
      {
        "name": "Wells Fargo",
        "address": {
          "city": "New York",
          "state": "NY",
          "county": "Big Apple",
          "zip_code": "10001",
          "default_field": null,
          "address_line_1": "123 WF St",
          "address_line_2": ""
        },
        "bank_phone": "333-333-3333",
        "bank_account_number": "33300000003"
      }
    ],
    "irc_date": "2001-06-02",
    "ntee_code": "X",
    "ohio_bingo": "true",
    "accountants": [
      {
        "name": "H&R Block",
        "address": {
          "city": "San Diego",
          "state": "CA",
          "county": "",
          "zip_code": "93789",
          "default_field": null,
          "address_line_1": "33e 3rd St",
          "address_line_2": ""
        }
      },
      {
        "name": "Johnson Baker",
        "address": {
          "city": "Honolulu",
          "state": "HI",
          "county": "",
          "zip_code": "99999",
          "default_field": null,
          "address_line_1": "505 Main St",
          "address_line_2": ""
        }
      }
    ],
    "percent_fund": "4",
    "auditor_title": "CPA",
    "board_members": [
      {
        "email": "name1@dogoodfoundation.org",
        "hours": "40",
        "phone": {
          "value": "555-555-5555",
          "default_field": null
        },
        "title": "Title 1",
        "salary": "100000",
        "address": {
          "city": "Suite 1000",
          "state": "CA",
          "county": "SF",
          "zip_code": "12345",
          "default_field": "nonprofit_address",
          "address_line_1": "123 Main St",
          "address_line_2": "San Francisco"
        },
        "last_name": "Last name 1",
        "first_name": "First name 1",
        "middle_name": "",
        "responsible_for_custody_of": "custody_of_funds,custody_of_records"
      },
      {
        "email": "name2@dogoodfoundation.org",
        "hours": "40",
        "phone": {
          "value": "123-456-7890",
          "default_field": "nonprofit_phone"
        },
        "title": "Title 2",
        "salary": "85000",
        "address": {
          "city": "Suite 1000",
          "state": "CA",
          "county": "SF",
          "zip_code": "12345",
          "default_field": "nonprofit_address",
          "address_line_1": "123 Main St",
          "address_line_2": "San Francisco"
        },
        "last_name": "Last name 2",
        "first_name": "First name 2",
        "middle_name": "",
        "responsible_for_custody_of": "responsible_for_fundraising,responsible_for_distribution_of_funds,responsible_for_signing_checks"
      }
    ],
    "nonprofit_fax": "123-456-7890",
    "oregon_assets": "99999",
    "assets_in_ohio": "true",
    "oregon_revenue": "9999999",
    "tax_deductible": "true",
    "by_laws_updated": "true",
    "irs_application": "true",
    "new_york_assets": "800000",
    "new_york_office": "true",
    "nonprofit_email": "example@dogoodfoundation.org",
    "nonprofit_phone": "123-456-7890",
    "signatory_email": "signer@dogoodfoundation.org",
    "signatory_title": "Executive Director",
    "cease_and_desist": "false",
    "date_established": "2001-01-20",
    "services_in_ohio": "true",
    "auditor_last_name": "Example",
    "dbas_with_florida": "",
    "denied_or_revoked": "false",
    "enjoined_by_court": "false",
    "government_grants": [
      {
        "name": "Fed Grant #1",
        "agency": "USAID",
        "amount": "100000"
      },
      {
        "name": "Fed Grant #2",
        "agency": "USAID",
        "amount": "2904389"
      }
    ],
    "nonprofit_address": {
      "city": "Suite 1000",
      "state": "CA",
      "county": "SF",
      "zip_code": "12345",
      "default_field": null,
      "address_line_1": "123 Main St",
      "address_line_2": "San Francisco"
    },
    "nonprofit_purpose": "Our mission is to create an inclusive and nurturing community",
    "nonprofit_website": "dogoodfoundation.org",
    "organization_name": "HODKIEWICZ ROBEL AND DONNELLY",
    "organization_type": "corporation",
    "auditor_first_name": "John",
    "california_raffles": "true",
    "convicted_of_crime": "false",
    "disposed_of_assets": "true",
    "irs_letter_updated": "true",
    "ohio_contributions": "50000",
    "ohio_distributions": "40000",
    "ohio_entity_number": "0510",
    "california_lobbying": "true",
    "city_established_in": "San Francisco",
    "convicted_of_felony": "false",
    "diversion_of_assets": "true",
    "federated_nonprofit": "true",
    "fundraising_methods": "corporate_solicitation,door_to_door,email,mail,online_marketing,phone",
    "ohio_board_meetings": "7",
    "signatory_last_name": "Doe",
    "bingo_license_number": "31460",
    "irs_application_date": "2001-01-01",
    "north_dakota_revenue": "30000",
    "percent_fund_managed": "9",
    "signatory_first_name": "Jane",
    "state_established_in": "CA",
    "states_registered_in": "AL,AK,AS,AR,CA,CO,CT,DE,DC,FL,GA,GU,HI,ID,IL,IN,IA,KS,KY,LA,ME,MD,MA,MI,MN,MS,MO,MT,NE,NV,NH,NJ,NM,NY,NC,ND,MP,OH,OK,OR,PA,PR,RI,SC,SD,TN,TX,TT,UT,VT,VI,VA,WA,WV,WI,WY",
    "irs_tax_exempt_status": "501(c)(3)",
    "loans_with_staff_ohio": "false",
    "misdemeanor_or_felony": "false",
    "signatory_middle_name": "",
    "subject_of_proceeding": "false",
    "commercial_co_ventures": "true",
    "new_york_contributions": "1234567",
    "north_dakota_disbursed": "20000",
    "second_signatory_email": "secondsigner@dogoodfoundation.org",
    "second_signatory_title": "CFO",
    "state_agency_agreement": "false",
    "california_car_donation": "true",
    "large_transactions_ohio": "false",
    "minnesota_contributions": "20394",
    "related_officers_vendor": "false",
    "subjected_to_proceeding": "true",
    "professional_fundraisers": "true",
    "tax_exempt_status_denied": "false",
    "financial_records_address": {
      "city": "Suite 1000",
      "state": "CA",
      "county": "SF",
      "zip_code": "12345",
      "default_field": "nonprofit_address",
      "address_line_1": "123 Main St",
      "address_line_2": "San Francisco"
    },
    "indebted_to_related_party": "false",
    "massachusetts_engage_date": "2001-07-23",
    "nonprofit_mailing_address": {
      "city": "Suite 1000",
      "state": "CA",
      "county": "SF",
      "zip_code": "12345",
      "default_field": "nonprofit_address",
      "address_line_1": "123 Main St",
      "address_line_2": "San Francisco"
    },
    "related_officers_internal": "true",
    "tax_exempt_status_revoked": "true",
    "transfer_to_related_party": "true",
    "articles_of_incorp_updated": "true",
    "california_raffles_details": "Raffle Details",
    "enjoined_by_court_employee": "false",
    "organization_contact_email": "contact@dogoodfoundation.org",
    "organization_contact_title": "Head of Impact",
    "receives_government_grants": "true",
    "second_signatory_last_name": "Doe",
    "sold_or_transferred_assets": "true",
    "solicitation_counties_ohio": "adams,allen,ashland,ashtabula,athens,auglaize",
    "tax_exempt_status_modified": "false",
    "washington_employees_names": [
      {
        "title": "Washington Title 3",
        "last_name": "Moneybags",
        "first_name": "Dr"
      },
      {
        "title": "Washington Title 1",
        "last_name": "Moneybags",
        "first_name": "Mr"
      },
      {
        "title": "Washington Title 2",
        "last_name": "Moneybags",
        "first_name": "Ms"
      }
    ],
    "california_lobbying_details": "Lobbying Details",
    "convicted_of_crime_employee": "true",
    "investment_in_related_party": "false",
    "paid_wages_to_related_party": "false",
    "related_officers_fundraiser": "false",
    "second_signatory_first_name": "John",
    "solicitation_not_year_round": "true",
    "west_virginia_contributions": "272727",
    "west_virginia_distributions": "4000",
    "agreement_with_related_party": "false",
    "chapters_branches_affiliates": [
      {
        "ein": "12-3456789",
        "type": "office",
        "state": "colorado",
        "address": {
          "city": "Boulder",
          "state": "CO",
          "county": "",
          "zip_code": "20002",
          "default_field": null,
          "address_line_1": "77 Rock St",
          "address_line_2": ""
        },
        "chapter_name": "",
        "chapter_phone": "258-234-5892",
        "contact_last_name": "Colorado",
        "contact_first_name": "Mr"
      },
      {
        "ein": "",
        "type": "chapter",
        "state": "ohio",
        "address": {
          "city": "Columbus",
          "state": "OH",
          "county": "",
          "zip_code": "65656",
          "default_field": null,
          "address_line_1": "88 Columbus Ave",
          "address_line_2": ""
        },
        "chapter_name": "",
        "chapter_phone": "234-234-2343",
        "contact_last_name": "Ohio",
        "contact_first_name": "Ms"
      }
    ],
    "convicted_of_felony_employee": "true",
    "second_signatory_middle_name": "",
    "applied_for_tax_exempt_status": "true",
    "donor_restricted_funds_loaned": "false",
    "disposed_of_assets_explanation": "oh test 1",
    "donor_restricted_funds_removed": "true",
    "nonprofit_programs_description": "We leads several charitable programs aimed at supporting the local community.",
    "organization_contact_last_name": "Doe",
    "tax_exempt_status_revoked_date": "1992-07-10",
    "california_car_donation_details": "Card Donation Details",
    "diversion_of_assets_explanation": "some explanation",
    "org_invested_in_corporate_stock": "false",
    "organization_contact_first_name": "Jane",
    "fundraising_agreements_last_year": [
      {
        "notes": "CCV Notes",
        "address": {
          "city": "Sacramento",
          "state": "CA",
          "county": "",
          "zip_code": "95758",
          "default_field": null,
          "address_line_1": "CCV St",
          "address_line_2": ""
        },
        "contract_type": "ccv",
        "payment_terms": "Terms 2",
        "states_included": "All",
        "amount_paid_to_fundraiser": "2000",
        "fundraising_activity_type": "Phone",
        "fundraising_agreement_name": "CCV Last Year",
        "fundraising_agreement_amount": "20000",
        "fundraising_agreement_end_date": "2025-07-29",
        "fundraising_agreement_start_date": "2025-07-22",
        "total_amount_paid_to_organization": "2001",
        "fundraising_agreement_signing_date": "2025-07-08",
        "gross_receipts_from_fundraising_activities": "2222000"
      },
      {
        "notes": "PFR Notes",
        "address": {
          "city": "Sacramento",
          "state": "CA",
          "county": "",
          "zip_code": "95758",
          "default_field": null,
          "address_line_1": "PFR St",
          "address_line_2": ""
        },
        "contract_type": "pfr",
        "payment_terms": "Terms 1",
        "states_included": "AL,AK,AS,AZ,AR,CA,CO,CT,DE,DC,FL,GA,GU,HI,ID,IL,IN,IA,KS,KY,LA,ME,MD,MA,MI,MN,MS,MO,MT,NE,NV,NH,NJ,NM,NY,NC,ND,MP,OH,OK,OR,PA,PR,RI,SC,SD,TN,TX,TT,UT,VT,VI,VA,WA,WV,WI,WY",
        "amount_paid_to_fundraiser": "1000",
        "fundraising_activity_type": "In-person",
        "fundraising_agreement_name": "PFR Last Year",
        "fundraising_agreement_amount": "100000",
        "fundraising_agreement_end_date": "2025-07-28",
        "fundraising_agreement_start_date": "2025-07-21",
        "total_amount_paid_to_organization": "1001",
        "fundraising_agreement_signing_date": "2025-07-07",
        "gross_receipts_from_fundraising_activities": "111111000"
      },
      {
        "notes": "PFRC notes",
        "address": {
          "city": "Sacramento",
          "state": "CA",
          "county": "",
          "zip_code": "95758",
          "default_field": null,
          "address_line_1": "PFRC St",
          "address_line_2": ""
        },
        "contract_type": "pfrc",
        "payment_terms": "Terms 3",
        "states_included": "AL,AK,AS,AZ,AR,CA,CO,CT,DE,DC,FL,GA,GU,HI,ID,IL,IN,IA,KS,KY,LA,ME,MD,MA,MI,MN,MS,MO,MT,NE,NV,NH,NJ,NM,NY,NC,ND,MP,OH,OK,OR,PA,PR,RI,SC,SD,TN,TX,TT,UT,VT,VI,VA,WA,WV,WI,WY",
        "amount_paid_to_fundraiser": "3000",
        "fundraising_activity_type": "E-marketing",
        "fundraising_agreement_name": "PFRC Last Year",
        "fundraising_agreement_amount": "300000",
        "fundraising_agreement_end_date": "2025-07-30",
        "fundraising_agreement_start_date": "2025-07-23",
        "total_amount_paid_to_organization": "3001",
        "fundraising_agreement_signing_date": "2025-07-09",
        "gross_receipts_from_fundraising_activities": "3333000"
      }
    ],
    "fundraising_agreements_this_year": [
      {
        "notes": "CCV Notes",
        "address": {
          "city": "Sacramento",
          "state": "CA",
          "county": "",
          "zip_code": "95758",
          "default_field": null,
          "address_line_1": "CCV St",
          "address_line_2": ""
        },
        "contract_type": "ccv",
        "payment_terms": "Terms 2",
        "states_included": "AL,AK,AS,AZ,AR,CA,CO,CT,DE,DC,FL,GA,GU,HI,ID,IL,IN,IA,KS,KY,LA,ME,MD,MA,MI,MN,MS,MO,MT,NE,NV,NH,NJ,NM,NY,NC,ND,MP,OH,OK,OR,PA,PR,RI,SC,SD,TN,TX,TT,UT,VT,VI,VA,WA,WV,WI,WY",
        "amount_paid_to_fundraiser": "77700",
        "fundraising_activity_type": "Phone",
        "fundraising_agreement_name": "CCV This Year",
        "fundraising_agreement_amount": "2222",
        "fundraising_agreement_end_date": "2025-07-21",
        "fundraising_agreement_start_date": "2025-07-14",
        "total_amount_paid_to_organization": "77701",
        "fundraising_agreement_signing_date": "2025-07-07",
        "gross_receipts_from_fundraising_activities": "565656"
      },
      {
        "notes": "PFR Notes",
        "address": {
          "city": "Sacramento",
          "state": "CA",
          "county": "",
          "zip_code": "95758",
          "default_field": null,
          "address_line_1": "PFR St",
          "address_line_2": ""
        },
        "contract_type": "pfr",
        "payment_terms": "Terms 1",
        "states_included": "AL,AK,AS,AZ,AR,CA,CO,CT,DE,DC,FL,GA,GU,HI,ID,IL,IN,IA,KS,KY,LA,ME,MD,MA,MI,MN,MS,MO,MT,NE,NV,NH,NJ,NM,NY,NC,ND,MP,OH,OK,OR,PA,PR,RI,SC,SD,TN,TX,TT,UT,VT,VI,VA,WA,WV,WI,WY",
        "amount_paid_to_fundraiser": "88800",
        "fundraising_activity_type": "In-person",
        "fundraising_agreement_name": "PFR This Year",
        "fundraising_agreement_amount": "11111",
        "fundraising_agreement_end_date": "2025-07-22",
        "fundraising_agreement_start_date": "2025-07-15",
        "total_amount_paid_to_organization": "88801",
        "fundraising_agreement_signing_date": "2025-07-08",
        "gross_receipts_from_fundraising_activities": "787878"
      },
      {
        "notes": "PFRC Notes",
        "address": {
          "city": "Sacramento",
          "state": "CA",
          "county": "",
          "zip_code": "95758",
          "default_field": null,
          "address_line_1": "PFRC St",
          "address_line_2": ""
        },
        "contract_type": "pfrc",
        "payment_terms": "Terms 3",
        "states_included": "AL,AK,AS,AZ,AR,CA,CO,CT,DE,DC,FL,GA,GU,HI,ID,IL,IN,IA,KS,KY,LA,ME,MD,MA,MI,MN,MS,MO,MT,NE,NV,NH,NJ,NM,NY,NC,ND,MP,OH,OK,OR,PA,PR,RI,SC,SD,TN,TX,TT,UT,VT,VI,VA,WA,WV,WI,WY",
        "amount_paid_to_fundraiser": "99900",
        "fundraising_activity_type": "E-marketing",
        "fundraising_agreement_name": "PFRC This Year",
        "fundraising_agreement_amount": "3333",
        "fundraising_agreement_end_date": "2025-07-23",
        "fundraising_agreement_start_date": "2025-07-16",
        "total_amount_paid_to_organization": "99901",
        "fundraising_agreement_signing_date": "2025-07-09",
        "gross_receipts_from_fundraising_activities": "454545"
      }
    ],
    "furnished_goods_to_related_party": "false",
    "irs_determination_effective_date": "1990-07-09",
    "organization_contact_middle_name": "",
    "professional_fundraising_counsel": "true",
    "org_make_grant_award_contribution": "false",
    "solicitation_contract_unfulfilled": "",
    "authorized_by_other_authority_ohio": "true",
    "professional_solicitation_services": "true",
    "unlawful_practices_final_judgement": "false",
    "acquired_goods_from_RP_compensation": "false",
    "compensated_members_for_fundraising": "true",
    "property_held_in_name_of_person_org": "false",
    "subjected_to_proceeding_explanation": "some explanation",
    "transferred_income_to_for_use_by_RP": "false",
    "financial_transactions_with_interest": "true",
    "related_officers_internal_explanation": "some explanation",
    "solicitation_not_in_all_counties_ohio": "true",
    "transfer_to_related_party_explanation": "some explanation",
    "leased_assets_to_or_from_related_party": "false",
    "mississippi_board_member_contact_email": "drew@ststephens.org",
    "mississippi_board_member_contact_phone": "888-800-8000",
    "mississippi_board_member_contact_title": "Head of Mississippi Relations",
    "sold_or_transferred_assets_explanation": "some explanation",
    "convicted_of_crime_employee_explanation": "some explanation",
    "org_party_to_transaction_w_fin_interest": "false",
    "solicitation_not_year_round_explanation": "Jun 1 - Jun 30",
    "convicted_of_felony_employee_explanation": "some explanation",
    "mississippi_board_member_contact_2_email": "steve@dogoodfoundation.org",
    "mississippi_board_member_contact_2_phone": "222-200-2000",
    "mississippi_board_member_contact_2_title": "Head of Mississippi Programs",
    "mississippi_board_member_contact_address": {
      "city": "Yazoo City",
      "state": "MS",
      "county": "",
      "zip_code": "33333",
      "default_field": null,
      "address_line_1": "333 River Road",
      "address_line_2": ""
    },
    "tax_exempt_status_denied_revoked_modified": "true",
    "donor_restricted_funds_removed_explanation": "Mass test 1",
    "mississippi_board_member_contact_2_address": {
      "city": "Buloxi",
      "state": "MS",
      "county": "",
      "zip_code": "33332",
      "default_field": null,
      "address_line_1": "444 Delta Circle",
      "address_line_2": ""
    },
    "mississippi_board_member_contact_last_name": "Doe",
    "mississippi_board_member_contact_first_name": "Jane",
    "mississippi_board_member_contact_2_last_name": "Doe",
    "mississippi_board_member_contact_middle_name": "",
    "mississippi_board_member_contact_2_first_name": "Steve",
    "authorized_by_other_authority_ohio_explanation": "some explanation",
    "mississippi_board_member_contact_2_middle_name": "",
    "financial_transactions_with_interest_explanation": "some explanation"
  }
}

Documents

API endpoints to assist with document management (for nonprofit renewal filing).

Create a document

post /api/v1/documents

Creates a document from a URL.

Parameters

url string

The URL of the document.

type string

The type of the document. The only valid type is: "990".

extract_data boolean

Whether to extract the data from the document. If true, the document will be analyzed.

Request 

curl https://api.getchange.io/api/v1/documents \
  -u YOUR_PUBLIC_KEY:YOUR_SECRET_KEY \
  -H "Content-Type: application/json" \
  -d '{
        "url": "https://example.com/990.pdf",
        "type": "990",
        "extract_data": true
      }'

Response

{
  "id": "doc_MJUPSpsMzp",
  "extraction_status": "queued",
  "extraction_data": {}
}

Retrieve a document

get /api/v1/documents/{id}

Retrieves a document.

Parameters

id string (in path) REQUIRED

The ID of the document.

Request 

curl https://api.getchange.io/api/v1/documents/doc_LfPGYuypy8 \
  -u YOUR_PUBLIC_KEY:YOUR_SECRET_KEY

Response

{
  "id": "doc_LfPGYuypy8",
  "extraction_status": "done",
  "extraction_data": {
    "part_i_20_end_of_year": "635264",
    "part_i_21_end_of_year": "371126",
    "part_i_12_current_year": "10000",
    "part_i_14_current_year": "10000",
    "part_i_15_current_year": "4560",
    "part_i_17_current_year": "1075629",
    "part_i_19_current_year": "-815489"
  }
}
Made with ❤ in San Francisco | Changelog | Status