---
title: "Ask the Delta Analyst (agentic OSINT/GEOINT Q&A)"
method: POST
path: "/api/v1/analyst"
---

# Ask the Delta Analyst (agentic OSINT/GEOINT Q&A)

`POST /api/v1/analyst`

## Request

- Base URL: `https://offnadir-delta.com`
- URL: `https://offnadir-delta.com/api/v1/analyst`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Costs 5–123 tokens, metered by the compute the question actually uses; the exact charge is returned in meta.tokens.charged (once, on completion). Follows the key owner's plan — whether Delta Agent is included and how many questions a month (a refusal is 403 with `denial` naming the plan that opens it) — and is metered on your token balance. Hybrid async: waits up to ~95s and returns the brief (200); a longer run returns 202 with a job_id — poll GET /api/v1/analyst/{jobId}, or re-send the SAME Idempotency-Key header to re-fetch the finished brief without a second charge. Timing: most questions finish in ~30–90s; a complex brief (satellite-imagery lookups or many sources) can take 2–3 minutes, so the 202 path is expected for those.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `question` string, required: The analytic question (≤ 500 chars).
  - `bbox` number[]: Optional focus bounding box [minLon, minLat, maxLon, maxLat] (WGS84).
  - `mode` 'fast' | 'deep': fast (default) or deep. Deep enables extended reasoning and wider evidence-gathering budgets for forecasting, collection trade-offs and market-implication questions; it is slower and the ceiling rises from 123 to 415 tokens. Charging stays metered by what the run actually consumes.

## Response `200`

Structured analyst brief (meta.tokens has the charge; meta.job_id identifies the run).

## Other responses

- `202`: Run still in progress; finished in the background. Poll poll_url for the brief.
- `400`: Error response with a stable machine-readable code.
- `401`: Error response with a stable machine-readable code.
- `402`: Error response with a stable machine-readable code.
- `403`: Error response with a stable machine-readable code.
- `429`: Error response with a stable machine-readable code.

---

[API](https://skmtc.dev/offnadir-delta/apis/off-nadir-delta-api.md) · [All operations](https://skmtc.dev/offnadir-delta/apis/off-nadir-delta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/offnadir-delta/apis/off-nadir-delta-api/revisions/5cf3f2bed5a2?raw)
