Skip to main content

Documentation Index

Fetch the complete documentation index at: https://momogood.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

GET {EMS_BASE_URL}/<your-namespace>/v1/events
Returns events the dedicated service user has access to and that have changed since the since cursor.
This endpoint is available on the Custom Data Export family only today. The Salesforce and Blackbaud connector namespaces don’t expose a list-events endpoint — those integrations typically receive event IDs out-of-band from the destination CRM.
Coming Soon — list-events on the connector families. Contact support@givergy.com if you need it.
Custom Data Export endpoints require a dedicated service user provisioned per customer. Contact support@givergy.com to set up your integration.

Authorization

The authenticated caller must be the dedicated service user provisioned for your Custom Data Export integration. Any other authenticated user receives 403 Forbidden. See Authentication → Authorization rules per family.

Query parameters

NameTypeDefaultNotes
sincelong (epoch seconds)1606062358Lower bound on updated. Use -1 to backfill everything.
orderBystringcreatedAscSee ordering options below.
offsetint0Pagination offset.
limitint1000Page size. Maximum 1000.

Ordering options

orderBy accepts any of: createdAsc, createdDesc, updatedAsc, updatedDesc, eventDateAsc, eventDateDesc, startTimeAsc, startTimeDesc, endTimeAsc, endTimeDesc, nameAsc, nameDesc, clientNameAsc, clientNameDesc, agentNameAsc, agentNameDesc, venueNameAsc, venueNameDesc

Response

Event[] — Custom Data Export variant. Includes projectType and externalId fields not present on the connector variants.

Example

curl --cookie session.cookie \
  '{EMS_BASE_URL}/<your-namespace>/v1/events?since=1714000000&orderBy=updatedDesc&limit=100'
[
  {
    "id": "8f3c2a1d-9b4e-4c7a-a1d2-6e5f4c3b2a10",
    "name": "Spring Charity Gala 2026",
    "status": "active",
    "inAidOf": "Hope Foundation",
    "startTime": 1715250600,
    "endTime": 1715279400,
    "eventDate": 1715250600,
    "timezone": "Europe/London",
    "currency": "GBP",
    "created": 1709123456,
    "updated": 1714003200,
    "projectType": "auction",
    "externalId": "EXT-2026-SPRING-001"
  }
]

What’s in the response

See the full Event schema for the field-by-field reference. Key things to know:
  • All amounts are integers in the event’s minor currency unit (see Conventions → Money fields).
  • Timestamps are Unix epoch seconds in UTC.
  • status is always "active" because of the implicit active-only filter on list endpoints.
  • timezone is an IANA timezone id (e.g. Europe/London, America/New_York).

Next steps

Once you have an event id, fetch its detail: For ongoing sync, see the polling pattern.