Sandbox (Energy)

With the Sandbox, we provide a fully functional environment for developing your application and integration testing our APIs. It supports unlimited End-Users and consents with realistic, production-like data.

We host ⚡ Fiskil SandBox Energy, a data holder simulation for the energy industry which you are able to access via Fiskil console. In this guide we'll create a new consent using console, then walk through the process of fetching sample data via the API.

Prerequisites

We assume you already have access to Fiskil Console. For the necessary permissions, and setting up the sandbox environment for your team, contact customer support.

Getting Started

Step 1: Generate API Key

If you haven't previously created one, navigate to API Keys in Fiskil console, to create a key pair. Take note of your client_id and client_secret for authentication purposes.

Step 2: Get an access token

Exchange your client_id and client_secret for an access token using the /token endpoint. Note down the token value.

curl --location --request POST 'https://api.fiskil.com/v1/token' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data-raw '{
    "client_id": "${client_id}",
    "client_secret": "${client_secret}"
}'

Step 3: Create An End-User

We'll create a new End-User to test the energy API. If this is your first ever consent, we recommend to create only one consent per End-User which makes it easier to work with the sample data. To create an End-User, you will need a name, email and phone. Remember to set the access token from the previous step.

curl --location --request POST 'https://api.fiskil.com/v1/token' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data-raw '{
    "client_id": "${client_id}",
    "client_secret": "${client_secret}"
}'

Step 4: Create Auth Session

Next, navigate to End-Users in Fiskil console, select the user you've just created and then click on "Create Auth Session". Copy the link into a new browser window.

In the new browser window, complete the step to allow access for your app independently by clicking on "Allow", you should now see the retailer selection in the next step.

Step 5: Select The Sandbox Retailer

Select ⚡ Fiskil SandBox Energy from the retailer selection screen.

Step 6: Complete OTP Authentication

Enter any email you have access to, then click on "get code". You will receive and one-time password in your inbox.

After entering the one-time password, you will be shown the account selection on the next screen.

Step 7: Account Selection

Select one of the energy accounts for your consent. It is recommended to stick to one account to limit data included in your consent. For a full reference of the available accounts, see the table below.

Energy Accounts

Account closed. Data from closed accounts may continue to be shared, i.e. when the customer has multiple energy accounts with the same provider. For details see cdr guidance on closed accounts.

After selecting the account, independently confirm the consent by selecting "Confirm and share" on the next screen. You have successfully created a consent in the sandbox environment.