Skip to main content
Published: August 11 2006, 12:35:00 PMUpdated: November 28 2020, 2:23:56 PM

For a Charity Item, why does get Item return a CharityID and a CharityNumber? What does CharityNumber correspond to? What should I do with the CharityNumber?

eBay uses MissionFish for its Giving Works Program.  The CharityIDs in the eBay database is different from that of the MissionFish.  Hence in the GetItem call for a charity item, you get both the Ids.  Here is a snippet of the GetItem response for the Charity Container:

<Charity>
  <CharityName>Archbishop Spalding High School</CharityName>
  <CharityNumber>498</CharityNumber>
  <DonationPercent>75.0</DonationPercent>
  <CharityID>389</CharityID>
  <Mission>Providing a unique environment where students are challenged to develop their academic, spiritual and athletic abilities and to engage in community service and responsible citizenship.</Mission>
  <LogoURL>http://missionfish.ibs.aol.com/logos/no_image.gif</LogoURL>
  <Status>Valid</Status>
</
Charity>

CharityID corresponds to the number in the eBay database and CharityNumber corresponds to the MissionFish database.  For the purpose of eBay API calls, you can ignore CharityNumber, as it is used by MissionFish for doing the mapping for the donation.

When you list your item, you need to use the eBay CharityID in the AddItem request.

Here is a sample AddItem request to list a Charity Item:

<?xml version="1.0" encoding="utf-8"?>
<AddItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <
Version>473</Version>
  <
Item>
    <
Charity>
      <
DonationPercent>75</DonationPercent>
      <
CharityID>389</CharityID>
    </
Charity>
    <
Country>US</Country>
    <
Currency>USD</Currency>
    <
Description>Description</Description>
    <
ListingDuration>Days_7</ListingDuration>
    <
ListingType>Chinese</ListingType>
    <
PostalCode>95125</PostalCode>
    <
PaymentMethods>PayPal</PaymentMethods>
    <
PayPalEmailAddress>test@test.com</PayPalEmailAddress>
    <
PrimaryCategory>
      <
CategoryID>30120</CategoryID>
    </
PrimaryCategory>
    <
Quantity>1</Quantity>
    <
ShipToLocations>None</ShipToLocations>
    <
StartPrice currencyID="USD">9.99</StartPrice>
    <
Title>title</Title>
  </
Item>
  <
RequesterCredentials>
    <
eBayAuthToken>*****</eBayAuthToken>
  </
RequesterCredentials>
</
AddItemRequest>

To Get a list of all the Charities and the CharityIDs, you can make a call to GetCharities

For more information on Charities, please see the section Identifying Listings that Benefit Nonprofits in the documentation.

How well did this answer your question?
Answers others found helpful