Read recurring and pledge commitment amounts in the API

In the recurring-subscriptions response, distinguish these fields:

• total: the stored finite subscription commitment, serialized as a string; null for an indefinite subscription.
• installment_amount: the scheduled installment amount.
• total_paid: the subscription paid total.
• total_remaining: the remaining amount as exposed by the subscription.
• installments[].value: that individual installment's amount.
• max_charges: the finite maximum charge count; null for indefinite subscriptions.
• recurs_indefinitely: whether the subscription is indefinite.

Do not sum the commitment again for every installment or multiply a rounded installment to infer an exact pledge total. The current pledge calculation preserves the donor-entered pledge total when that metadata exists; older records can require reconciliation. Use the correct subscription response and associated record identifiers rather than interpreting an individual gift/installation value as the whole commitment.

The response fields do not provide a command to generate extra sandbox payments immediately. For accelerated integration test data, ask Support to confirm the approved sandbox procedure. Do not change production billing dates to create test data.

Negative incentive deductible amount in the Gifts API

The Gifts API incentive.tax_deductible_amount is contribution value minus the linked incentive fair-market value. This serialization has no zero floor, so it can return a negative number when FMV exceeds that value; no linked incentive returns null. Do not apply receipt-display rules to this API field or interpret -1 as a documented sentinel. Verify the exact API/report column, gift value, reward and FMV before correcting a specific record. A school-approved receipt/tax interpretation requires separate review.

Can I list all pledges that have no payment information?

The ordinary Gifts and Recurring Subscriptions list endpoints are not a complete feed of unpaid pledge commitments.

A pledge can exist before any money is collected. A scheduled pledge without payment information can also have a subscription record, but that subscription is pending and is excluded from the recurring-subscriptions list. Finding an individual subscription when you already know its ID does not mean the list endpoint includes it.

The Gifts list filters on its supported payment states; an unpaid pledge commitment does not become a paid gift merely because it has a gift ID. Do not invent a no_payment filter or count the pledged commitment as cash received.

For a complete administrator review of commitments, use Online Giving → Reporting → Donations → Pledges and export the pledge commitments. Reconcile payments separately. If your integration requires a complete automated feed of these commitments, ask Support about your available reporting options instead of assuming the standard list endpoints supply it.