---
title: "Ask a question against a customer's entity-scoped insights bundle"
method: POST
path: "/accountant/companies/{customerId}/intelligence/asks"
tags: ["Accountant Portal", "Insights"]
---

# Ask a question against a customer's entity-scoped insights bundle

`POST /accountant/companies/{customerId}/intelligence/asks`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/accountant/companies/{customerId}/intelligence/asks`
- Auth: HTTP bearer

## Query parameters

- `entityId` string, uuid

## Request body

- InsightAskInput
  - `question` string, required
  - `period` 'last_30_days' | 'last_90_days' | 'month_to_date'
  - `industry` string
  - `parentAskId` string, uuid

## Response `200`

Insight answer

- InsightAskAnswerResponse
  - `success` true, required
  - `data` InsightAskAnswer, required
    - `id` string, uuid
    - `companyId` string, uuid, required
    - `entityId` string, uuid, required
    - `question` string, required
    - `answer` string, required
    - `confidence` number, nullable, required
    - `metricKeys` string[], required
    - `sourceRefs` MetricSourceRef[], required
      - `type` 'overview' | 'report' | 'aging' | 'marketing' | 'stripe' | 'document' | 'transaction' | 'manual', required
      - `id` string, required
      - `label` string, required
    - `computedAt` string, date-time, required

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)