List merge batches (paginated)
Returns a paginated list of DuplicateMergeBatch records for the caller’s client. Each batch includes bounded donor, operator, field-name, and relationship-count summaries for admin review. Restore ledgers, field values, processor identifiers, and internal errors are never returned. Standard Laravel pagination envelope (20 per page). Requires permission: duplicates_manage (also satisfied by donors_manage).
Authorizations
Passport bearer token authentication for legacy admin sessions.
Query Parameters
Restrict to one donor form.
Search batch reference, status, operator, or donor identity before pagination.
120Restrict history to one batch status.
completed, undone, failed, processing, pending Restrict history to the calendar day shown to the administrator.
IANA timezone used to calculate exact calendar-day boundaries, including daylight-saving transitions.
"America/New_York"
Offset fallback for clients that do not provide an IANA timezone. Use the offset on the selected date.
-840 <= x <= 840Response
Paginated batches.
Standard Laravel LengthAwarePaginator JSON envelope. The data array contains the page's items and is the only field whose shape varies per endpoint — wrap this schema in an allOf and override data to point at the resource type. The remaining fields are paginator metadata.
1-indexed current page number.
1
Page items. Override this in endpoint-specific schemas with a $ref to the resource type.
Page size.
25
Total number of items across all pages.
287
"https://api.gratona.com/v1/donors?page=1"
1-indexed position of the first item on this page (null when the page is empty).
1
Total number of pages.
12
"https://api.gratona.com/v1/donors?page=12"
"https://api.gratona.com/v1/donors?page=2"
"https://api.gratona.com/v1/donors"
null
1-indexed position of the last item on this page (null when the page is empty).
25
Pagination link objects emitted by Laravel's paginator (sometimes present, sometimes omitted depending on the endpoint).