# Search for a Charity for your Donation

**Payment API** - **CharitySearch - API specification** provides searching for nonprofit charity organizations you would like to make a donation to. 

**API Overview:**

* **API Version:** v1
* **Endpoint:** [`/api/CharitySearch`](/welcome-to-our-payment-api/api-references/test-payment-api-features/charity-search.md#get-api-charitysearch)
* **Method:** GET

This endpoint supports a **GET** request for searching nonprofit charities with various filters.

**Parameters:**

1. **Name** (optional): Partial or full name of the charity (max 70 characters).
2. **EIN** (optional): Valid US/CA Nonprofit EIN or Tax ID (9–15 characters).
3. **CharitySource** (optional): Specifies whether the charity is from the US (1) or Canada (2).
4. **City** (optional): City name associated with the charity's address (max 30 characters).
5. **State** (optional): State code (ISO standard 2-letter code).
6. **PageIndex** (optional): Page number for paginated results (default is 1).
7. **PageSize** (optional): Number of results per page (default is 10).
8. **SortColumn** (optional): Column by which to sort the results (default is NpoName).
9. **SortDesc** (optional): Boolean to specify whether to sort in descending order.

**Responses:**

* **200 OK**: Returns charity search data in JSON format with details like total results, pagination, and charity records.
* **400 Bad Request**: If the request has errors, it returns a list of broken rules.
* **404 Not Found**: If no charity records match the search criteria, a detailed problem message is returned.

**Data Models:**

1. **CharitySearchResults**: Contains total result count, total pages, and a list of charity records.
2. **CharitySearchResultsList**: Includes details for each charity, such as:
   * CharityId: Unique identifier
   * NpoName: Charity name
   * EIN: Tax ID
   * Address: Charity's address
   * NpoEligibilityFlag: Indicates tax-deductible donation eligibility
   * ParentOrgName: Parent charity (if applicable)
   * NTEEcode: IRS classification code for US charities
3. **BrokenRule**: Describes errors in the request with an error code and message.
4. **ProblemDetails**: Provides detailed error messages if the data is not found or there is an issue.

### Try out our Charity Search API

This API is useful for searching charity organizations by various criteria and retrieving detailed records. 

{% content-ref url="/pages/5J0Jg3izotCZ4l4Dq0zV" %}
[Charity Search](/welcome-to-our-payment-api/api-references/test-payment-api-features/charity-search.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.frontstream.com/welcome-to-our-payment-api/api-references/search-for-a-charity-for-your-donation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.