Concession

Returns the details of any concessions or arrangements applied to a specific energy account.

Concession Endpoints

get/v1/energy/concessions

The Concession model

Retrieves a Concession object.

Attributes

Expand all
concessions
arrayrequired
Show child attributes
Show child attributes
Response
{
    "concessions": [
        {
            "account_id": "acc123",
            "additional_info": "The government issued a one-off rebate for electricity plans",
            "additional_info_uri": "https://www.energy.com/rebate",
            "amount": "40.00",
            "applied_to": [
                "CONTROLLED_LOAD",
                "INVOICE"
            ],
            "arrangement_id": "arr678",
            "discount_frequency": "P1Y",
            "display_name": "Government Rebate",
            "end_date": "2024-12-31",
            "fiskil_id": "energy_concession_abcdef123",
            "institution_id": "140",
            "percentage": "0.05",
            "start_date": "2024-01-01",
            "type": "FIXED_AMOUNT"
        }
    ],
    "links": {
        "next": "https://api.fiskil.com/v1/accounts?page[after]=x",
        "prev": "https://api.fiskil.com/v1/accounts?page[before]=x"
    }
}
GET

/v1/energy/concessions

List all Concessions

Returns the details of any concessions or arrangements applied to a specific energy account.

Parameters

end_user_idstringrequired

A unique identifier for the End User object.

page[before]string

When the page[before] is specified, backwards pagination is achieved

page[after]string

When the page[after] is specified, forwards pagination is achieved

page[size]integer

When the page[size] is specified, no more than page[size] resources will be included in the response's data field. This parameter is set to a sensible default, which varies depending on the endpoint.

Request
GET /v1/energy/concessions
curl --request GET \
     --url https://api.fiskil.com/v1/v1/energy/concessions?end_user_id={end_user_id}&page[before]={page[before]}&page[after]={page[after]}&page[size]={page[size]} \
     --header 'Authorization: Bearer {access_token}' \
     --header 'accept: application/json; charset=UTF-8' \
     --header 'content-type: application/json; charset=UTF-8' 
Response
{
    "concessions": [
        {
            "account_id": "acc123",
            "additional_info": "The government issued a one-off rebate for electricity plans",
            "additional_info_uri": "https://www.energy.com/rebate",
            "amount": "40.00",
            "applied_to": [
                "CONTROLLED_LOAD",
                "INVOICE"
            ],
            "arrangement_id": "arr678",
            "discount_frequency": "P1Y",
            "display_name": "Government Rebate",
            "end_date": "2024-12-31",
            "fiskil_id": "energy_concession_abcdef123",
            "institution_id": "140",
            "percentage": "0.05",
            "start_date": "2024-01-01",
            "type": "FIXED_AMOUNT"
        }
    ],
    "links": {
        "next": "https://api.fiskil.com/v1/accounts?page[after]=x",
        "prev": "https://api.fiskil.com/v1/accounts?page[before]=x"
    }
}

Was this page helpful?