Missing Field Present in API Documentation

Justin Beasley

It appears that the recurring_gift_schedule field that's documented on Gifts List (both GET and POST versions) isn't actually returned by the API for any items. We've confirmed this across multiple instances, including the SKY API Developer instance—they show on the gift record in the UI, but are not returned in the API call despite being listed in the documentation (as returning a RecurringGiftScheduleRead struct.

While this field does seem to be present in the single Gift (Get) response, they aren't returned by either form of List. And in our use case, it would be VERY request/API-intensive to loop over all of them for every Gift record returned from the list (since we're doing an initial historical backfill which can be millions of gifts for some orgs using NXT).

At minimum this is a docs bug, but I also think it's very much missing functionality that's needed for a lot of use cases to correctly classify gift frequency.

Is there any way to get the Gifts List endpoint to return the recurring_gift_schedule values?

Alex Wong

@Justin Beasley
If you haven't already, might want to search Idea Bank and see if there's already an idea that you can vote on or submit one.

You will also want to submit a support case and state the bug (this is either a code bug that a field is not returned, or a documentation bug that states the field being returned but actually not). There are other fields that is only availble when doing single record get vs list get, so if BB response is a documentation bug, it is going to be difficult to get them to expose that field as list endpoint comes from the RODS.

If this field is availble in database field Query, you can try using Query API to get bulk.

Jordan Yarr

@Justin Beasley

I don't recall where I read this but I believe recurring gift schedule in the gift list endpoint refers only to the schedule of recurring gifts automated in web view. Is that limitation consistent with your attempt to confirm the bug?

Erik Leaver

@Jordan Yarr I believe that's correct. @Justin Beasley look at

on a process to get the gifts you need.