Reconcile identified donations and bank outcomes

Read the authenticated partner's financial integration journal (up to 100 updates per page). Includes donor profile data for your existing reporting and ChMS integrations. When the church also works with another partner (linked: existing_church), the journal carries the donations of enrollments made through your platform; those made through the other partner are not included, and those made on the church's own giving page are not included for any platform. Donor profiles here are the ones the donor gave in donor sessions you created (for a donor recorded before contract 1.3.0, the latest profile until they next give their details through you). donor.updated reports a contact change the donor made in a donor session you created; a change made in another partner's donor session, or directly with Roster, is not included. Store each event and its next_cursor atomically. Deduplicate event_id across this feed and signed webhooks. Apply a donation snapshot only if its revision is greater than the revision already stored for that donation. Sequence orders journal ingestion, not bank finality. An empty page echoes the cursor you sent (null on a first poll with nothing to read); keep polling from the cursor you stored and never replace it with null. This journal is separate from the activity feed at /v1/events. It begins when financial integration is enabled. Bootstrap may include retained stream records (up to 24 hours), not complete historical coverage. A stack without the integration configured returns 503.

Query Parameters

since_cursor
Type: string
max length:
1024

Opaque next_cursor from this partner's previous financial page.

Responses

application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json

get/v1/financial_events

curl https://api.sandbox.rostergiving.com/v1/financial_events \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Show Schema

{
  "events": [
    {
      "event_id": "string",
      "event_type": "donation.updated",
      "sequence": 1,
      "occurred_at": "2026-10-22T14:55:08.127Z",
      "church_id": "string",
      "entity_id": "string",
      "livemode": true,
      "payload": {
        "revision": "string",
        "id": "string",
        "church_id": "string",
        "enrollment_id": null,
        "donor_id": null,
        "method": "paycheck",
        "currency": "USD",
        "amount_minor": null,
        "status": "received",
        "received_at": null,
        "updated_at": "2026-10-22T14:55:08.127Z",
        "residual_minor": null,
        "transfers": [
          {
            "role": "church",
            "amount_minor": null,
            "reference": null,
            "status": "submitted"
          }
        ],
        "return_details": {
          "role": null,
          "code": null,
          "amount_minor": null,
          "reference": null,
          "occurred_at": "2026-10-22T14:55:08.127Z"
        },
        "donor": {
          "id": "string",
          "given_name": "string",
          "family_name": "string",
          "email": null,
          "phone": null,
          "updated_at": null,
          "address": {
            "line1": "string",
            "city": "string",
            "state": "string",
            "postal_code": "string"
          }
        },
        "donor_data_status": "available",
        "refunded_minor": 0,
        "funds": [
          {
            "id": "string",
            "name": "string",
            "percent": 1,
            "amount": 1,
            "amount_minor": null,
            "refunded_minor": 0
          }
        ]
      }
    }
  ],
  "next_cursor": null
}

Committed financial updates, in sequence order.

Events

Read the activity event feed