Reporting

Get liability rollforward

Returns the period liability rollforward decomposed by action type; lines sum exactly to closing minus opening, with no residual plug. This report does not accept created_after or created_before.

get/v1/reports/liability-rollforward

Request

Base URL: https://api.scrip.dev
URL: https://api.scrip.dev/v1/reports/liability-rollforward
Auth: HTTP bearer

Query parameters

period_startstring date-time required

Start of the reporting period, inclusive, RFC 3339.

period_endstring date-time required

End of the reporting period, inclusive, RFC 3339.

program_idstring uuid

Filter to rows attributed to a specific program

asset_idstring uuid

Filter to a specific asset

Response

Liability rollforward

period_endstring

Period end (inclusive, RFC 3339), echoed from the request

period_startstring

Period start (inclusive, RFC 3339), echoed from the request

Example response

{
  "data": [
    {
      "adjustments_net": "0.00",
      "asset_id": "a3bb189e-8bf9-4c8b-9be0-6b5d2f4e7a02",
      "asset_name": "Loyalty Points",
      "asset_symbol": "POINTS",
      "bucket_movements_net": "0.00",
      "closing_balance": "563400.00",
      "debited": "300.00",
      "expired": "0.00",
      "forfeited": "2000.00",
      "holds_voided": "0.00",
      "issuance_returns": "500.00",
      "issued": "150000.00",
      "opening_balance": "500000.00",
      "program_id": "8f14e45f-ceea-4e70-9df8-2a7d1b3c9f01",
      "program_name": "Acme Rewards",
      "redeemed": "85000.00",
      "redemption_receipts": "0.00",
      "redemption_reversals": "1200.00",
      "reversal_clawbacks": "0.00",
      "scale": 2,
      "transfers_net": "0.00"
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "YWJjMTIz"
  },
  "period_end": "2027-12-31T23:59:59Z",
  "period_start": "2027-01-15T10:30:00Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.