How to retrieve details for a gift sitting in a batch

Marlin Integrations
Marlin Integrations
Fourth Anniversary Kudos 1 Name Dropper Facilitator 1
in Blackbaud Raiser's Edge NXT® APIs

Hello,

We are trying to figure out how to retrieve details for a gift sitting in a batch.

When we use this POST method to push a gift into a batch we receive a gift ID

330eaf37562b666cfadbe6dc9d8fb3d4-huge-im

However when we try to fetch the details of the gift using GET Gift endpoint

The data we receive doesn't belong to the same gift. It either displays data for some other gift record or returns 404 not found.

This indicates that the ID received in the POST Gift (batch) is not an actual gift ID and the gift in a batch is not an actual gift but rather some other object.

Example:

We received ID 676495 and we can see this ID when clicking on the gift in the batch

3f67c5cb573ad3ea5d955d7a1ab81444-huge-im

The donation amount of this gift is $32

When we tried to use the GET Gift endpoint using this ID we received a gift with a different amount & constituent, etc.

c0db636992779223cdf6a6398601322b-huge-im

Our question is:

Is there a way to fetch the details for a gift in batch? Is there a dedicated API endpoint for this?

We thought about making a call to fetch the gift batch to get the list of included gifts however there's no such an endpoint

Any advice will be highly appreciated

Comments

  • Alex Wong
    Alex Wong Community All-Star
    Tenth Anniversary Kudos 5 Facilitator 4 bbcon 2025 Attendee Badge

    @Marlin Integrations
    A gift that has been added to a web gift batch is not consider a “real” gift record yet, so using the GET gift endpoint would fail.

    What are you trying to do with gift info from a unapproved batch?

  • Marlin Integrations
    Marlin Integrations
    Fourth Anniversary Kudos 1 Name Dropper Facilitator 1

    @Alex Wong
    Thanks for the response.

    We are pushing donations from our website into RE NXT. We would like to record & use the GIFT ID so we can later verify whether all of the gift attributes have been set up properly (e.g. custom fields).

    We would also like to be able to reference the real gift record against the website donation (so you can check whether the donation has been correctly synced as a gift). Since the Gift ID we receive while pushing the gift into a batch is not an actual gift ID and there's no way to receive the actual gift ID once the gift in a batch is approved we are looking for a way to use the received ID to later identify the actual gift.

    I hope that makes sense

  • Alex Wong
    Alex Wong Community All-Star
    Tenth Anniversary Kudos 5 Facilitator 4 bbcon 2025 Attendee Badge

    @Marlin Integrations
    A gift that is in a batch is not a real gift as mentioned, so there is no way to pull up the info for verification, and since there is no API for approving/commiting a web batch, it has to be done manually by human at this time. So what you trying to do won't work as the API is now.

    Instead, you may want to consider not adding to a gift batch for the specific situation. You can simply just add the gift record directly using POST gift API endpoint. this way, the gift record id returned is the actual gift record that you can use any Gift API endpoint on. This method or not is up to if your finance team is ok with not having a batch.

Categories