Gift List by Constituent via Gift API

Bob Rowe

I am simply looking to pull a list of Gifts by constituent id. The Gift API indicates this should be doable with this built URI

but result is always an empty array even when I have verified via RENXT the constituentId and the fact they have a gift.

Any suggestions?

Ben Lambert

@Bob Rowe One thing to check is to make sure you're using the constituent “system record ID” and not the “user-defined constituent ID”. You can get the system record ID from the address bar in the browser (so in your example, do you see 111 in the address bar when you navigate to a constituent record in RENXT like this:

https://host.nxt.blackbaud.com/constituent/records/111?svcid=renxt&envid=YOURENVIRONMENTID

Bob Rowe

@Ben Lambert

Thanks… I figured that out after some experimentation.

Also, any insights into the differences between.

“Constituent Id” - User Defined
“System Id” - Internal Unique Identifier
“Lookup Id” - ??
“Integration Id” - ?? (assume with your own 3rd Party DB/system)

Seems like a lot to keep track of.

Ben Lambert

@Bob Rowe Thanks for the feedback, we know this is a confusing aspect of the developer program - these are concepts that have long histories and many reasons why they are named what they are, and it's difficult to find the right language to use for all audiences (customers, end-users, developers, citizen developers, etc.).

We have some documentation that might be useful to read here:

https://docs.blackbaud.com/microsoft-connectors-docs/microsoft-power-platform/basics/key-concepts

Most of that is oriented towards Power Platform users but some of the concepts aren't exclusive to that audience and we might consider moving some content into the developer portal docs.