Getting Started

Welcome to Fiskil! This guide will help you get up and running with your Fiskil integration in no time. Whether you're building a banking or energy application, follow these steps to connect your users' accounts and start pulling data.

1. Create Your Fiskil Account

Start by creating an account through the Fiskil Console. Once registered, you can generate your API keys and access the tools needed to integrate Fiskil into your app or website.

2. Authenticate with Fiskil

Fiskil authenticates your API requests using API keys generated from the console. Here's how to exchange your API keys for an access token:

Generate API Keys

In the Fiskil Console, generate your client_id and client_secret.

Request an Access Token

Make a POST request to the /v1/token endpoint:

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

3. Create an End User

An End User represents a user of your app. You need to create this object to link accounts and manage consent.

Create an End User

Make a POST request to /v1/end-user with the user's details:

curl --request POST \
--url https://api.fiskil.com/v1/end-user \
--header 'Authorization: Bearer ${access_token}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "email": "user@example.com",
    "name": "User Name",
    "phone": "+1234567890"
}'

Store the end_user_id returned in the response for future API calls.

4. Set Up Your Consent Flow

Fiskil's APIs are use case agnostic, but it's crucial to ensure your users understand what data they're consenting to share.

Customize Consent in the Console

Navigate to the Customize UI page in the Fiskil Console.

Update:

• Consent Period: Choose an appropriate duration
• Data History: Limit history to what's necessary for faster sync
• Use Cases: Clearly describe why you need access
• Branding: Add your logo, company name, and adjust colors to match your brand

5. Create an Auth Session

An Auth Session facilitates linking a user's account through the consent flow you designed.

Create an Auth Session

Make a POST request to /v1/auth/session:

curl --request POST \
--url https://api.fiskil.com/v1/auth/session \
--header 'Authorization: Bearer ${access_token}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "cancel_uri": "https://yourapp.com/cancel",
    "end_user_id": "${end_user_id}",
    "redirect_uri": "https://yourapp.com/redirect"
}'

Handle the Response

{
  "auth_url": "https://auth.fiskil.com/?session_id=your_session_id",
  "expires_at": "2025-12-31T23:59:59Z",
  "session_id": "your_session_id"
}

Redirect users to the auth_url. This will launch the consent flow UI you configured.

6. Pull Data Using Fiskil APIs

Once the user has completed the consent flow, you can access their data using Fiskil's Banking or Energy APIs.

Banking APIs

Energy APIs

Need Help?

Not a developer? No worries! Reach out to Fiskil's certified experts or explore our Open Source examples.

🎉 That's it! You're now set up with Fiskil. Let us know what you're building—we'd love to help you out or even feature your product on our blog.