Query recent gifts through the API

For GiveCampus integrations and API.

For a date-window query, supply start and end as Unix timestamps in seconds, select the intended time field, and enable the desired state parameters with true. The query recognizes authorized, charged_back, disputed, failed, paid, pending, pending_authorization and refunded. More than one state can be requested. There is no universally best state: paid targets paid gifts, while reconciliation or troubleshooting may need several states. Including pending or failed gifts does not make them collected revenue.

The recognized time_field values are captured_at, checkout_at, created_at, deposited_at, refunded_at and updated_at; the fallback is confirmed_at. For recently created records, use created_at; for changed records use updated_at with appropriate reconciliation safeguards. A gift without a value in the chosen timestamp field will not match that date comparison. Bounds are inclusive in the query.

If a request returns nothing, check the school/API scope, seconds versus milliseconds, dates, chosen timestamp and selected states against one known gift. ID and deposit-ID lookups take separate branches instead of the ordinary state/date filtering. Follow endpoint pagination and response handling in the API specification; the filter rules alone do not confirm a complete synchronization strategy.