---
title: Charity API
description: "The eBay **Charity API** provides buyers and sellers a formal way to search for supported charitable organizations and charitable organization details. **Note:** The **Charity API** is supported only in the UK and US marketplaces. For more information about using RESTful APIs, see [Get started with eBay APIs](/develop/guides-v2/get-started-with-ebay-apis/get-started-with-ebay-apis#overview) and [Using eBay RESTful APIs](/develop/guides-v2/using-ebay-restful-apis/using-ebay-restful-apis#overview). #### Sandbox vs. Production data The data in the eBay Sandbox environment is static. It can be limited in scope and quantity, and is sometimes simulated or mock data. As a result, you should not depend on data in the Production environment to have the same limitations. Use good coding practices to anticipate the wider range and variability of data that your application is likely to encounter."
api_version: 1.0
api_name: charity_api
api_type: REST
api_group: sell/charity_api
source_url:
  html: https://developer.ebay.com/develop/api/sell/charity_api
  md: https://developer.ebay.com/develop/api/sell/charity_api.md
---

# Charity API API

The eBay **Charity API** provides buyers and sellers a formal way to search for supported charitable organizations and charitable organization details.

**Note:** The **Charity API** is supported only in the UK and US marketplaces.

For more information about using RESTful APIs, see [Get started with eBay APIs](/develop/guides-v2/get-started-with-ebay-apis/get-started-with-ebay-apis#overview) and [Using eBay RESTful APIs](/develop/guides-v2/using-ebay-restful-apis/using-ebay-restful-apis#overview).

#### Sandbox vs. Production data

The data in the eBay Sandbox environment is static. It can be limited in scope and quantity, and is sometimes simulated or mock data. As a result, you should not depend on data in the Production environment to have the same limitations. Use good coding practices to anticipate the wider range and variability of data that your application is likely to encounter.

## API Methods

The following API methods are available:

### getCharityOrg

#### GET /charity_org/{charity_org_id}
**Description:** This call is used to retrieve detailed information about supported charitable organizations. It allows users to retrieve the details for a specific charitable organization using its charity organization ID.
**Parameters:**
- **charity_org_id** (string) *required*
  - The unique ID of the charitable organization.
- **X-EBAY-C-MARKETPLACE-ID** (string) *required*
  - A header used to specify the eBay marketplace ID.  
  
**Valid Values:** `EBAY_GB` and `EBAY_US`

### getCharityOrgs

#### GET /charity_org
**Description:** This call is used to search for supported charitable organizations. It allows users to search for a specific charitable organization, or for multiple charitable organizations, from a particular charitable domain and/or geographical region, or by using search criteria.  
  
The call returns paginated search results containing the charitable organizations that match the specified criteria.
**Parameters:**
- **limit** (string)
  - The number of items, from the result set, returned in a single page.  
  
**Valid Values:** `1-100`  
  
**Default:** `20`
- **offset** (string)
  - The number of items that will be skipped in the result set. This is used with the **limit** field to control the pagination of the output.  
  
For example, if the **offset** is set to `0` and the **limit** is set to `10`, the method will retrieve items 1 through 10 from the list of items returned. If the **offset** is set to `10` and the **limit** is set to `10`, the method will retrieve items 11 through 20 from the list of items returned.  
  
**Valid Values:** `0-10,000`  
  
**Default:** `0`
- **q** (string)
  - A query string that matches the keywords in name, mission statement, or description.
- **registration_ids** (string)
  - A comma-separated list of charitable organization registration IDs.  
  
**Note:** Do not specify this parameter for query-based searches. Specify either the **q** or **registration\_ids** parameter, but not both.  
  
**Maximum Limit:** `20`
- **X-EBAY-C-MARKETPLACE-ID** (string) *required*
  - A header used to specify the eBay marketplace ID.  
  
**Valid Values:** `EBAY_GB` and `EBAY_US`

## Error Codes

The following error codes may be returned by this API:

### REQUEST Errors

#### 165001 - API_CHARITY
**Description:** Invalid, missing or unsupported marketplace. Please refer to documentation.

#### 165002 - API_CHARITY
**Description:** Charity Org Id is invalid or missing.

#### 165003 - API_CHARITY
**Description:** The specified limit is invalid. Maximum value supported is 100.

#### 165004 - API_CHARITY
**Description:** The specified offset is invalid.

#### 165005 - API_CHARITY
**Description:** Please specify registration\_ids OR query text for the search.

### APPLICATION Errors

#### 165000 - API_CHARITY
**Description:** There was a problem with an eBay internal system or process. Contact eBay developer support for assistance.

## Rate Limits

See [API Call Limits](https://developer.ebay.com/develop/get-started/api-call-limits) on the eBay Developer Program.

## Resources

### Documentation

- [eBay Developer Program](https://developer.ebay.com/)
- [API Documentation](https://developer.ebay.com/develop/api/)
- [SDKs and Widgets](https://developer.ebay.com/develop/sdks-and-widgets)
- [Developer Community Forum](https://community.ebay.com/t5/Developer-Groups/ct-p/developergroup)

### Tools

- [API Explorer](https://developer.ebay.com/my/api_test_tool)
- [GraphQL Explorer](https://developer.ebay.com/my/graphql_explorer)

### Support

- [Developer Support](https://developer.ebay.com/support/)
- [API Status](https://developer.ebay.com/support/api-status)
- [Release Notes](https://developer.ebay.com/develop/api/release_notes/)

---
*Generated on 2026-07-07T22:27:48.211Z*