Send a receipt for a periodic statement

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 '
{
  "periodStart": "2026-09-01",
  "statementDeliveredAt": "2026-10-03T14:31:00Z"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({periodStart: '2026-09-01', statementDeliveredAt: '2026-10-03T14:31:00Z'})
};

fetch('https://api.lightspark.com/grid/2025-10-13/internal-accounts/{id}/confirm-statement', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

val client = OkHttpClient()

val mediaType = MediaType.parse("application/json")
val body = RequestBody.create(mediaType, "{\n  \"periodStart\": \"2026-09-01\",\n  \"statementDeliveredAt\": \"2026-10-03T14:31:00Z\"\n}")
val request = Request.Builder()
  .url("https://api.lightspark.com/grid/2025-10-13/internal-accounts/{id}/confirm-statement")
  .post(body)
  .addHeader("Authorization", "Basic <encoded-value>")
  .addHeader("Content-Type", "application/json")
  .build()

val response = client.newCall(request).execute()

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

{
  "code": "INVALID_INPUT",
  "reason": "<string>",
  "details": {
    "errors": [
      {
        "field": "identifier",
        "constraint": {
          "format": "email",
          "pattern": "^\\d{5}(-\\d{4})?$",
          "enum": [
            "SSN",
            "ITIN",
            "NON_US_TAX_ID"
          ],
          "minLength": 1,
          "maxLength": 500
        },
        "message": "Value is not one of the allowed enum members."
      }
    ],
    "missingRequirements": [
      "SUPPORTING_PROOF"
    ]
  }
}

{
  "code": "UNAUTHORIZED",
  "reason": "<string>",
  "details": {}
}

{
  "code": "TRANSACTION_NOT_FOUND",
  "reason": "<string>",
  "details": {}
}

{
  "code": "TRANSACTION_NOT_PENDING_PLATFORM_APPROVAL",
  "reason": "<string>",
  "details": {}
}

{
  "code": "GRID_SWITCH_ERROR",
  "reason": "<string>",
  "details": {}
}

Periodic Statements

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.

periodStart names the period: the first day of the statement month, as a date. It must be the first of a month, and 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 --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 '
{
  "periodStart": "2026-09-01",
  "statementDeliveredAt": "2026-10-03T14:31:00Z"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({periodStart: '2026-09-01', statementDeliveredAt: '2026-10-03T14:31:00Z'})
};

fetch('https://api.lightspark.com/grid/2025-10-13/internal-accounts/{id}/confirm-statement', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

val client = OkHttpClient()

val mediaType = MediaType.parse("application/json")
val body = RequestBody.create(mediaType, "{\n  \"periodStart\": \"2026-09-01\",\n  \"statementDeliveredAt\": \"2026-10-03T14:31:00Z\"\n}")
val request = Request.Builder()
  .url("https://api.lightspark.com/grid/2025-10-13/internal-accounts/{id}/confirm-statement")
  .post(body)
  .addHeader("Authorization", "Basic <encoded-value>")
  .addHeader("Content-Type", "application/json")
  .build()

val response = client.newCall(request).execute()

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

{
  "code": "INVALID_INPUT",
  "reason": "<string>",
  "details": {
    "errors": [
      {
        "field": "identifier",
        "constraint": {
          "format": "email",
          "pattern": "^\\d{5}(-\\d{4})?$",
          "enum": [
            "SSN",
            "ITIN",
            "NON_US_TAX_ID"
          ],
          "minLength": 1,
          "maxLength": 500
        },
        "message": "Value is not one of the allowed enum members."
      }
    ],
    "missingRequirements": [
      "SUPPORTING_PROOF"
    ]
  }
}

{
  "code": "UNAUTHORIZED",
  "reason": "<string>",
  "details": {}
}

{
  "code": "TRANSACTION_NOT_FOUND",
  "reason": "<string>",
  "details": {}
}

{
  "code": "TRANSACTION_NOT_PENDING_PLATFORM_APPROVAL",
  "reason": "<string>",
  "details": {}
}

{
  "code": "GRID_SWITCH_ERROR",
  "reason": "<string>",
  "details": {}
}

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

The id of the internal account whose statement was delivered.

Body

application/json

periodStart

string<date>

required

First day of the statement period the receipt covers, a calendar month in US Central time. Must be the first day of a month that has already begun.

Example:

"2026-09-01"

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

Receipt recorded

internalAccountId

string

required

The account whose statement this is

Example:

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

periodStart

string<date>

required

First day of the statement period

Example:

"2026-09-01"

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"

Using the API

API documentation

Send a receipt for a periodic statement

Authorizations

Path Parameters

Body

Response