# Lightspark Periodic Statements API

**Canonical:** https://apis.io/apis/lightspark/lightspark-periodic-statements-api/  
**Provider:** Lightspark — https://apis.io/providers/lightspark/  
**Base URL:** https://api.lightspark.com/grid/2025-10-13  
**Documentation:** https://docs.lightspark.com/

Lightspark Periodic Statements API is one of 24 APIs that [Lightspark](https://apis.io/providers/lightspark/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Periodic Statements. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and 1 JSON Schema.

Build, deliver, and evidence a Regulation E periodic statement for a customer's internal account. A statement period is a calendar month in US Central time (`America/Chicago`). A statement is issued for each customer's own USD internal account and covers their whole balance. Money received through a rule-based account appears on its owner's statement; rule-based, bulk settlement and platform-owned accounts have no statement of their own. **1. The statement — `GET /internal-accounts/{id}/balance-changes?startDate=&endDate=`** One row per change to the balance, in the order the money moved, with the opening and closing balances for the window in the same response. Page until `hasMore` is false, then assert this identity across every page before you render anything: ``` openingBalance + Σ(data[].amount) == closingBalance ``` If it does not hold, do not send the statement; contact support instead. `startDate` and `endDate` bound a half-open window `[startDate, endDate)`: for a monthly statement, pass the first instant of the month and the first instant of the following month, both in US Central time (for August 2026, `2026-08-01T00:00:00-05:00` and `2026-09-01T00:00:00-05:00`). Grid records a statement as fetched only for a window that is exactly one such month. **2. The receipt — `POST /internal-accounts/{id}/confirm-statement`** Once a month, after you have pulled and issued a period's statement, send a receipt with the `statementMonth` it covers. Grid stores it as the delivery record for that account and period. Sending it again is harmless: the first receipt's time is kept. **Timing** A window whose card settlement has not closed is refused with `409 NOT_YET_AVAILABLE` rather than answered with figures that could still change; retry once it has settled.

## Operations (2)

| Method | Path | Summary |
|---|---|---|
| GET | `/internal-accounts/{id}/balance-changes` | List balance changes for a period |
| POST | `/internal-accounts/{id}/confirm-statement` | Send a receipt for a periodic statement |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/lightspark/refs/heads/main/openapi/lightspark-periodic-statements-api-openapi.yml
- **Documentation** — https://docs.lightspark.com/
- **APIReference** — https://docs.lightspark.com/api-reference/authentication
- **Spectral** — https://raw.githubusercontent.com/api-evangelist/lightspark/refs/heads/main/rules/lightspark-grid-spectral.yaml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/lightspark/refs/heads/main/asyncapi/lightspark-grid-webhooks.yml
- **SourceCode** — https://github.com/lightsparkdev/grid-api
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/lightspark/refs/heads/main/json-schema/lightspark-uma-provider-list-response-schema.json

## Other Lightspark APIs (12)

- [Lightspark Agent Management API](https://apis.io/apis/lightspark/lightspark-agent-management-api/)
- [Lightspark Agent Operations API](https://apis.io/apis/lightspark/lightspark-agent-operations-api/)
- [Lightspark API Tokens API](https://apis.io/apis/lightspark/lightspark-api-tokens-api/)
- [Lightspark Cards API](https://apis.io/apis/lightspark/lightspark-cards-api/)
- [Lightspark Contact Verification API](https://apis.io/apis/lightspark/lightspark-contact-verification-api/)
- [Lightspark Cross-Currency Transfers API](https://apis.io/apis/lightspark/lightspark-cross-currency-transfers-api/)
- [Lightspark Customers API](https://apis.io/apis/lightspark/lightspark-customers-api/)
- [Lightspark Discoveries API](https://apis.io/apis/lightspark/lightspark-discoveries-api/)
- [Lightspark Documents API](https://apis.io/apis/lightspark/lightspark-documents-api/)
- [Lightspark Embedded Wallet Auth API](https://apis.io/apis/lightspark/lightspark-embedded-wallet-auth-api/)
- [Lightspark Exchange Rates API](https://apis.io/apis/lightspark/lightspark-exchange-rates-api/)
- [Lightspark External Accounts API](https://apis.io/apis/lightspark/lightspark-external-accounts-api/)

## Tags

Periodic Statements

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/lightspark/lightspark-periodic-statements-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/lightspark/.