Skip to main content
POST
/
v1
/
energy
/
customer
/
{customerId}
/
accounts
/
billing
Get Billing For Specific Accounts
curl --request POST \
  --url https://api.provider.fiskil.com/v1/energy/customer/{customerId}/accounts/billing \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": {
    "accountIds": [
      "account-1",
      "account-2"
    ]
  }
}
'
{
  "data": {
    "transactions": [
      {
        "accountId": "019a0a0b-6bff-7952-99c7-73c8c4967655",
        "usage": {
          "amount": "120.00",
          "adjustments": [
            {
              "amount": "-10.00",
              "description": "Meter read correction"
            }
          ],
          "isEstimate": false,
          "endDate": "2025-10-31",
          "usage": 72.13,
          "servicePointId": "019a0a0b-c27b-7fd3-bd84-9bead0e73711",
          "invoiceNumber": "125",
          "description": "Usage fees Q3",
          "measureUnit": "KWH",
          "calculationFactors": [
            {
              "type": "DLF",
              "value": 6.027456183070403
            }
          ],
          "timeOfUseType": "ALL_DAY",
          "startDate": "2025-09-01"
        },
        "gst": "12.00",
        "transactionUType": "usage",
        "executionDateTime": "2025-11-01T00:00:00"
      },
      {
        "accountId": "019a0a0b-6bff-7952-99c7-73c8c4967655",
        "payment": {
          "amount": "100.00",
          "method": "DIRECT_DEBIT"
        },
        "transactionUType": "payment",
        "executionDateTime": "2025-09-010T10:25:00"
      }
    ]
  },
  "meta": {
    "totalRecords": 2,
    "totalPages": 1
  },
  "links": {
    "first": "page=1&page-size=25&oldest-date=2023-04-24",
    "last": "page=4&page-size=25&oldest-date=2023-04-24",
    "next": "page=3&page-size=25&oldest-date=2023-04-24",
    "prev": "page=1&page-size=25&oldest-date=2023-04-24"
  }
}

Authorizations

​
Authorization
string
header
required

The Fiskil Data Provider will include a self-signed JWT as a Bearer token in the Authorization header. You should verify this JWT using the JWKS URL you can find for your Data Provider instance in the Fiskil Console. To verify the JWT you must:

  • Verify the signature
  • Ensure the token has not expired by checking the exp claim
  • The sub and iss claims are your data provider subdomain
  • The aud claim is the URI of the resource being requested (excluding any query parameters)
  • The jti value is unique For further detail on security and authentication refer to our Authentication documentation

Path Parameters

​
customerId
string
required

Unique ID of a customer. This ID must not change for the lifecycle of the customer

Query Parameters

​
newest-time
string

Constrain the request to records with effective time at or before this date/time. If absent defaults to current date/time. Format is an RFC3339 Datetime string.

​
oldest-time
string

Constrain the request to records with effective time at or after this date/time. If absent defaults to newest-time minus 12 months. Format is an RFC3339 Datetime string.

​
page
integer

Page of results to request (standard pagination)

​
page-size
integer

Page size to request. Default is 25 (standard pagination)

Body

application/json

Request payload containing list of specific Accounts to obtain data for

​
data
object
required

Response

List of billing transactions for the requested accounts

​
data
object
required
​
links
object
required

URL Query parameters to obtain different pages of the response. Fiskil will combine these with the rest of the request URL to build full link URLs in the final response.

Example:
{
  "first": "page=1&page-size=25&oldest-date=2023-04-24",
  "last": "page=4&page-size=25&oldest-date=2023-04-24",
  "next": "page=3&page-size=25&oldest-date=2023-04-24",
  "prev": "page=1&page-size=25&oldest-date=2023-04-24"
}
​
meta
object
required
Example:
{ "totalRecords": 150, "totalPages": 6 }