---
title: "Top-N ranked candidates for a question"
method: GET
path: "/api/ask"
tags: ["answer"]
---

# Top-N ranked candidates for a question

`GET /api/ask`

## Request

- Base URL: `https://signals.gitdealflow.com`
- URL: `https://signals.gitdealflow.com/api/ask`
- Auth: none declared
- TypeScript: <https://skmtc.dev/gitdealflow/apis/vc-deal-flow-signal-api/docs/api/ask/get.ts> (a function with typed inputs; its response is checked against the schema)

Sibling of /api/answer. Returns ranked candidates instead of a single best match, for autocomplete UX or comparison.

## Query parameters

- `q` string, required
- `limit` integer

## Response `200`

Ranked candidates

- object
  - `query` string
  - `hits` AnswerHit[]
    - `question` string
    - `answer` string
    - `url` string, uri
    - `source` 'agent-query' | 'faq'
    - `confidence` number
    - `facts` object[]
      - `claim` string
      - `sourceUrl` string, uri
    - `related` object[]
      - `question` string
      - `url` string, uri

## Changes

- **2026-08-14** `e8fe6095df09`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gitdealflow/apis/vc-deal-flow-signal-api/changes/api/ask/get.md)

---

[API](https://skmtc.dev/gitdealflow/apis/vc-deal-flow-signal-api.md) - [All operations](https://skmtc.dev/gitdealflow/apis/vc-deal-flow-signal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gitdealflow/apis/vc-deal-flow-signal-api/revisions/1150ac4e7a23?raw)