---
title: "Questions Lodestar is asking about household data"
method: GET
path: "/api/v1/questions"
tags: ["lodestar"]
---

# Questions Lodestar is asking about household data

`GET /api/v1/questions`

## Request

- Base URL: `https://worthune.com`
- URL: `https://worthune.com/api/v1/questions`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`

Deterministic data checks run in every household cycle; at most one question is open per mandate. Filters: status, mandateId, householdId.

## Query parameters

- `status` 'open' | 'answered' | 'confirmed' | 'stale'
- `mandateId` integer
- `householdId` integer

## Response `200`

Newest first, at most 200.

- object
  - `ok` unknown, required
  - `questions` Question[], required
    - `id` integer, required
    - `mandateId` integer, required
    - `householdId` integer, required
    - `householdVersion` integer, required
    - `source` 'data-check' | 'planner', required
    - `checkId` string
    - `path` object, required
      - `collection` 'accounts' | 'incomes' | 'expenses' | 'liabilities' | 'members', required
      - `itemId` string, required
      - `field` string, required
    - `why` string, required
    - `currentValue` unknown
    - `status` 'open' | 'answered' | 'confirmed' | 'stale', required
    - `answer` unknown
    - `answeredBy` string, nullable
    - `answeredAt` string, date-time, nullable
    - `changeProposalId` integer, nullable
    - `createdAt` string, date-time, required
    - `href` string, required

## Other responses

- `400`: A malformed filter.
- `401`: No key presented (Authorization: Bearer wk_… or X-Api-Key).
- `402`: Unrecognized or revoked API key.
- `403`: The key predates organization support (contact support for a free rotation).
- `429`: Hourly per-org stateful quota, a per-route durable limit, or the 120 requests/minute per-IP burst backstop.
- `503`: Billing is not configured on this deployment; household resources are disabled rather than served without tenancy (production fail-closed).

---

[API](https://skmtc.dev/worthune/apis/worthune-api.md) · [All operations](https://skmtc.dev/worthune/apis/worthune-api/llms.txt) · [OpenAPI document](https://skmtc.dev/worthune/apis/worthune-api/revisions/9f2241072555?raw)
