Send a receipt for a periodic statement

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

Send a receipt for a periodic statement

cURL

curl --request POST \
  --url https://api.lightspark.com/grid/2025-10-13/internal-accounts/{id}/confirm-statement \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "statementMonth": "2026-09",
  "statementDeliveredAt": "2026-10-03T14:31:00Z"
}
'

200

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

Authorizations

Authorization · string · header · required

API token authentication using format <api token id>:<api client secret>

Path Parameters

id · string · required

The id of the internal account whose statement was delivered.

Body

application/json

statementMonth · string · 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.

Pattern: ^\d{4}-(0[1-9]|1[0-2])$

Example:

"2026-09"

statementDeliveredAt · string<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:

"2026-10-03T14:31:00Z"

Response

200

application/json

Receipt recorded

internalAccountId · string · required

The account whose statement this is

Example:

"InternalAccount:019542f5-b3e7-1d02-0000-000000000002"

statementMonth · string · required

The statement month, as YYYY-MM

Pattern: ^\d{4}-(0[1-9]|1[0-2])$

Example:

"2026-09"

statementDeliveredAt · string<date-time> · required

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

Example:

"2026-10-03T14:31:00Z"

fetchedAt · string<date-time>

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

Example:

"2026-10-01T09:00:00Z"