Insights Report

Once an account holder has granted consent with a VIEW flow (srv: "view_ais/user"), Feezback computes an insights report based on the aggregated data from all connected accounts. The report provides a financial view into a person's (or organizations) aggregated assets, obligations, balances and cashflow. This page covers how to consume that report — either as JSON through the API, or as a hosted dashboard page.

How it fits in the flow

1. Run the VIEW consent flow (view_ais/user) — see Open Banking Account Connection.
2. The user grants consent and Feezback pulls their data.
3. Feezback computes the insights report. Once ready, Feezback sends the UserInsightReady webhook — see Webhook Catalog.
4. From here you have two independent options, and you can use either or both:
   • Pull the report as JSON via the Insights API — the same ais/tpp bearer token you already use for other data endpoints.
   • Generate a hosted dashboard link (srv: "view/user") and get a link to a View page with a user friendly dashboard. This link is purely for viewing — it doesn't return JSON to you.

Option A: Getting the report as JSON

1. Create a bearer token.

   1. Create a JSON out of this payload:

{
  "sub": "sub",
  "iss": "tpp/{TPP_ID}",
  "srv": "ais/tpp",
  "iat": 1728986260,
  "exp": 1728986860,
  "ttl": 600
}

b. Sign the JWT with the RS512 algorithm.
Convert the JSON from the previous step into a JWT (JSON Web Token):
Sign the JWT with the private key that matches the public key you sent to Feezback.

For manual JWT signing see https://www.jwt.io/.

c. Send this JWT (from previous step) to the Token Generation API:

curl --location --request POST 'https://{ENVIRONMENT}.feezback.cloud/token' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "token": "{GENERATED_JWT_TOKEN}"
  }'

Replace {ENVIRONMENT} with one of these values:

3. The JSON response will include a token.
   Use the token value from the body for authenticating as Bearer against the TPP API, for the next 600 seconds.

2. Call the insights endpoint to get the insights report:

GET /tpp/v1/users/USERID/insights

This is a separate path from the hosted dashboard link below — getting the JSON uses the same ais/tpp bearer token / TPP API host pattern as any other data endpoint (accounts, transactions, etc.). See Data Aggregation & Enrichment for the token request.

curl --location 'https://{TPP_API_HOST}/tpp/v1/users/USERID/insights' \
  --header 'Authorization: Bearer {ACCESS_TOKEN}' \
  --header 'X-Tpp-Id: {TPP_ID}'

• Each field is calculated separately per currency.
• If a section is missing from the response, it means that insight isn't enabled on your plan — not that the user has no data for it.
• Like other AIS data endpoints, this call can return 307 while the report is still being computed — poll using the same X-Request-Wait / transactionId pattern described in Data Aggregation & Enrichment.

Option B: Generating an expiring hosted dashboard link

Create a JSON with srv: "view/user" and send it to /link.

Unlike the consent-granting JWT, this one doesn't need a flow block — the user has already consented.

{
  "sub": "user-123",
  "iss": "tpp/{TPP_ID}",
  "srv": "view/user",
  "userWasAuthenticated": true,
  "insightType": "private"
}

Sign the JWT with RS512, ES256, or EdDSA — same as any other LGS request. The response is JWE-encrypted, same as every /link response — see Security.

Call the relevant env. to get a VIEW link.

curl --location --request POST 'https://{ENVIRONMENT}.feezback.cloud/link' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "token": "{GENERATED_JWT_TOKEN}"
  }'

The link points to Feezback's hosted VIEW dashboard, carrying the encrypted token, your TPP ID, and the insight type as query parameters. Send the user to this link to view their report as a page.

The link expires 30 minutes after issuance and is reusable within that window — the user can open it more than once before it expires. Generate a new link once it expires.

Common questions