Count donors matching worksheet filters
Counts the same active/archive, saved view, search and advanced-filter donor scope without materializing a page. hysform_id is supplied in the body; omission selects all forms. Invalid sponsoring-program filters are rejected. A search that cannot be evaluated safely while the index is unavailable returns422 instead of an inaccurate count. Requires permission: one of donors_manage.
Authorizations
Passport bearer token authentication for legacy admin sessions.
Body
Validated request fields for this operation.
Donor form worksheet state. The path supplies form scope; filters/search/date/sort are resolved with saved view settings. filter is conditionally required with filterGroups. Pagination defaults to page1, size10; hysform_id=all combines forms.
Archived-view selector. Use string false for active and true for archived. Recipient views also support available, sponsored and unsponsored.
"false"
Multiple typed comparisons. Requires filter when present; value is required except supported presence/empty operators. Saved-view filters are sanitized to current allowed fields.
Worksheet search text; recipient search defaults to title/id fields when keysArray is absent.
"Jane"
Legacy comparison/search field keys.
Legacy single comparison operator.
"contains"
Saved view/report from this organization and worksheet module; missing/unmatched ids are ignored.
42
Compatibility alias for savedFilterId.
42
Selected column keys; defaults to saved/current form preferences.
Lower date bound, interpreted with module/saved report date semantics.
"2026-01-01"
Upper date bound; donor created-at range applies when both bounds are supplied and no advanced date override exists.
"2026-10-20"
Form scope; omitted/null/empty/all combines donor forms.
42
Response
Operation result.
x >= 042