---
title: "Creating an insights request."
method: POST
path: "/v1/insights/request"
tags: ["Insights"]
---

# Creating an insights request.

`POST /v1/insights/request`

## Query parameters

- `sandbox` boolean
- `callbackUri` string

## Headers

- `sessionId` string, uuid
- `authorizationId` string, uuid

## Request body

- CreateInsightsRequest
  - `country` 'se', required
  - `dropSharedAccounts` boolean, nullable
  - `dropJointAccounts` boolean, nullable
  - `period` integer, nullable
  - `currency` string, nullable

## Response `201`

Success

- InsightsRequestStatus
  - `id` string, uuid, required
  - `requestStatus` 'PENDING' | 'PROCESSING' | 'PROCESSED' | 'REJECTED', required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Server Error
- `503` — Server Error

---

[API](https://skmtc.net/finshark/apis/finshark-api.md) · [All operations](https://skmtc.net/finshark/apis/finshark-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/finshark/finshark-api/revisions/7fc3b4f800ae/schema)