May 14, 2025
Introducing the Funding Events API
Release date: May 14, 2025 (production)
Impact: New API endpoints for Funding Events visibility
Audience: Post-paid customers
Action required: None
Products affected: Funding Events API
Overview
Today, we are introducing a Funding Events API to provide enhanced visibility into your funding events. A funding event encompasses a series of collections used to fund transaction settlement over a specified period. Previously, settlement emails served as the main source of funding activity information; now, you can access this information programmatically through our API and webhook integrations, as well as trace your funding activity back to our settlement reporting.
Details
For complete endpoint specifications and implementation examples, please visit our API Reference.
Endpoints
| Method | Description | Path |
|---|---|---|
| GET | Retrieve all funding events | /v1/funding_events |
| GET | Retrieve a single funding event | /v1/funding_events/{funding_event_token} |
| GET | Obtain URLs for accessing the corresponding settlement summary and details | /v1/funding_events/{funding_event_token}/details |
Path Variables
| Parameter | Type | Required | Description |
|---|---|---|---|
| funding_event_token | string | ✓ | Unique identifier for the funding event. |
Funding Event Response
| Field | Type | Description |
|---|---|---|
| token | string | Unique identifier for the funding event |
| collection_tokens | array | List of unique identifiers of the associated collections |
| previous_high_watermark | date-time | Timestamp of the previous high watermark |
| high_watermark | date-time | Timestamp of the current high watermark |
| collection_resource_type | string | Type of collection resource |
| settlement_breakdowns | array | List of settlements, each containing amount and settlement_date |
| created | date-time | Timestamp when the funding event was created |
| updated | date-time | Timestamp when the funding event was last updated |
Funding Event Details Response
| Field | Type | Description |
|---|---|---|
| token | string | Unique identifier for the funding event detail |
| settlement_summary_url | string | URL to access the corresponding settlement summary |
| settlement_details_url | string | URL to access the corresponding settlement details |
Webhooks
Event webhooks for funding events will be published with the event type funding_event.created. Payloads will mirror the funding event response detailed above.
The Lithic changelog has an RSS feed! To monitor for new update announcements, subscribe with your preferred RSS reader.