Service Points - Data API API Reference

The Service Points endpoint provides information about National Metering Identifiers (NMIs) and meter details for energy accounts.

Endpoints

Method	Endpoint	Description
`GET`	`/v1/service-points`	Get service points for an end user

The Service Point Model

Attribute	Type	Description
`id`	string	Service point identifier (NMI)
`account_id`	string	Associated energy account ID
`address`	object	Address details for the service point
`classification`	string	Classification (SMALL, LARGE)
`status`	string	Connection status (ACTIVE, INACTIVE)
`meter_type`	string	Type of meter installed
`registers`	array	Meter register information

Example Response

{
  "id": "NMI123456789",
  "account_id": "energy_acc_123",
  "address": {
    "street": "123 Example Street",
    "suburb": "Sydney",
    "state": "NSW",
    "postcode": "2000"
  },
  "classification": "SMALL",
  "status": "ACTIVE",
  "meter_type": "SMART",
  "registers": [
    {
      "register_id": "E1",
      "register_type": "CONSUMPTION",
      "unit": "kWh"
    }
  ]
}

Get Service Points

Retrieve service point information for an end user's energy accounts.

GET https://api.fiskil.com/v1/service-points

Query Parameters

Parameter	Type	Required	Description
`end_user_id`	string	Yes	The ID of the end user
`account_id`	string	No	Filter by specific account ID
`page[size]`	integer	No	Number of results (max 1000)
`page[after]`	string	No	Cursor for pagination

Example Request

curl --request GET \
  --url 'https://api.fiskil.com/v1/service-points?end_user_id=482c0e2b-5866-46b1-b795-220b7bba45b5' \
  --header 'Authorization: Bearer {access_token}' \
  --header 'accept: application/json; charset=UTF-8'

const response = await fetch(
  'https://api.fiskil.com/v1/service-points?end_user_id=482c0e2b-5866-46b1-b795-220b7bba45b5',
  {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer {access_token}',
      'accept': 'application/json; charset=UTF-8'
    }
  }
);

const servicePoints = await response.json();

import requests

response = requests.get(
    'https://api.fiskil.com/v1/service-points',
    params={'end_user_id': '482c0e2b-5866-46b1-b795-220b7bba45b5'},
    headers={
        'Authorization': 'Bearer {access_token}',
        'accept': 'application/json; charset=UTF-8'
    }
)

service_points = response.json()

Example Response

{
  "data": [
    {
      "id": "NMI123456789",
      "account_id": "energy_acc_123",
      "address": {
        "street": "123 Example Street",
        "suburb": "Sydney",
        "state": "NSW",
        "postcode": "2000"
      },
      "classification": "SMALL",
      "status": "ACTIVE",
      "meter_type": "SMART",
      "registers": [
        {
          "register_id": "E1",
          "register_type": "CONSUMPTION",
          "unit": "kWh"
        }
      ]
    }
  ]
}

Meter Types

Type	Description
`SMART`	Smart meter with interval data
`BASIC`	Basic accumulation meter
`INTERVAL`	Interval meter (pre-smart)

Register Types

Type	Description
`CONSUMPTION`	Energy consumption register
`GENERATION`	Solar/generation export register
`DEMAND`	Demand measurement register

Usage - Get usage data for service points
DER - Get DER (solar/battery) data

The Service Points endpoint provides information about National Metering Identifiers (NMIs) and meter details for energy accounts.

Endpoints

Method	Endpoint	Description
`GET`	`/v1/service-points`	Get service points for an end user

The Service Point Model

Attribute	Type	Description
`id`	string	Service point identifier (NMI)
`account_id`	string	Associated energy account ID
`address`	object	Address details for the service point
`classification`	string	Classification (SMALL, LARGE)
`status`	string	Connection status (ACTIVE, INACTIVE)
`meter_type`	string	Type of meter installed
`registers`	array	Meter register information

Example Response

{
  "id": "NMI123456789",
  "account_id": "energy_acc_123",
  "address": {
    "street": "123 Example Street",
    "suburb": "Sydney",
    "state": "NSW",
    "postcode": "2000"
  },
  "classification": "SMALL",
  "status": "ACTIVE",
  "meter_type": "SMART",
  "registers": [
    {
      "register_id": "E1",
      "register_type": "CONSUMPTION",
      "unit": "kWh"
    }
  ]
}

Get Service Points

Retrieve service point information for an end user's energy accounts.

GET https://api.fiskil.com/v1/service-points

Query Parameters

Parameter	Type	Required	Description
`end_user_id`	string	Yes	The ID of the end user
`account_id`	string	No	Filter by specific account ID
`page[size]`	integer	No	Number of results (max 1000)
`page[after]`	string	No	Cursor for pagination

Example Request

curl --request GET \
  --url 'https://api.fiskil.com/v1/service-points?end_user_id=482c0e2b-5866-46b1-b795-220b7bba45b5' \
  --header 'Authorization: Bearer {access_token}' \
  --header 'accept: application/json; charset=UTF-8'

const response = await fetch(
  'https://api.fiskil.com/v1/service-points?end_user_id=482c0e2b-5866-46b1-b795-220b7bba45b5',
  {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer {access_token}',
      'accept': 'application/json; charset=UTF-8'
    }
  }
);

const servicePoints = await response.json();

import requests

response = requests.get(
    'https://api.fiskil.com/v1/service-points',
    params={'end_user_id': '482c0e2b-5866-46b1-b795-220b7bba45b5'},
    headers={
        'Authorization': 'Bearer {access_token}',
        'accept': 'application/json; charset=UTF-8'
    }
)

service_points = response.json()

Example Response

{
  "data": [
    {
      "id": "NMI123456789",
      "account_id": "energy_acc_123",
      "address": {
        "street": "123 Example Street",
        "suburb": "Sydney",
        "state": "NSW",
        "postcode": "2000"
      },
      "classification": "SMALL",
      "status": "ACTIVE",
      "meter_type": "SMART",
      "registers": [
        {
          "register_id": "E1",
          "register_type": "CONSUMPTION",
          "unit": "kWh"
        }
      ]
    }
  ]
}

Meter Types

Type	Description
`SMART`	Smart meter with interval data
`BASIC`	Basic accumulation meter
`INTERVAL`	Interval meter (pre-smart)

Register Types

Type	Description
`CONSUMPTION`	Energy consumption register
`GENERATION`	Solar/generation export register
`DEMAND`	Demand measurement register

Usage - Get usage data for service points
DER - Get DER (solar/battery) data