LIlightsparkdev
Periodic Statements

Send a receipt for a periodic statement

Changed on

Record your monthly receipt that you pulled and issued this account's periodic statement for a period. Grid stores it as the delivery record for that account and period.

Send it once a month for each account, after you have issued the statement built from GET /internal-accounts/{id}/balance-changes. Send it within five days of the month's end for every customer account: Grid checks then that every account's statement was issued.

statementMonth names the statement month as YYYY-MM, a calendar month in US Central time. It must be a month that has already begun.

Sending a receipt is idempotent. The stored time is the first receipt's, so calling this again does not move it.

post/internal-accounts/{id}/confirm-statement

Request

  • Base URL
    https://api.lightspark.com/grid/2025-10-13
  • URL
    https://api.lightspark.com/grid/2025-10-13/internal-accounts/{id}/confirm-statement
  • Auth
    HTTP basic

Request body

statementMonthstring required

The statement month the receipt covers, as YYYY-MM. A statement month is a calendar month in US Central time, and it must have already begun.

statementDeliveredAtstring date-time required

When you issued the statement to the customer. Must include a timezone offset, must not be in the future, and must be at or after the end of the period.

Example request

{
  "statementMonth": "2026-09",
  "statementDeliveredAt": "2026-10-03T14:31:00Z"
}

Response

Receipt recorded

internalAccountIdstring required

The account whose statement this is

statementMonthstring required

The statement month, as YYYY-MM

fetchedAtstring date-time

When the statement for this period was first read from Grid. Absent if it never has been

statementDeliveredAtstring date-time required

When the statement was issued, from the first receipt for this period. Later receipts do not move it.

Example response

{
  "internalAccountId": "InternalAccount:019542f5-b3e7-1d02-0000-000000000002",
  "statementMonth": "2026-09",
  "fetchedAt": "2026-10-01T09:00:00Z",
  "statementDeliveredAt": "2026-10-03T14:31:00Z"
}

Changes

  • d996ddfb9d2bRevision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • f11f1e76bdd7Revision changes
    • warning

      added the new PURCHASE_CARD_LIMIT_REACHED enum value to the response property for the response status