---
title: "The questions this workspace runs against the engines"
method: GET
path: "/questions"
---

# The questions this workspace runs against the engines

`GET /questions`

## Request

- Base URL: `https://app.aimentiontracker.ai/api/v1`
- URL: `https://app.aimentiontracker.ai/api/v1/questions`
- Auth: API key in header `X-API-Key`

Call this before interpreting a disappointing visibility number. Everything else in this API is derived from these questions, so a low figure may mean the wrong question rather than poor visibility, and the two have opposite fixes.

`web_search_volume` IS NULL WHEN UNCHECKED, not when it is zero. Read `volume_checked_at` before quoting demand: rendering an unchecked volume as 0 asserts nobody searches a question nobody has measured.

The allowance in meta counts ACTIVE questions across the whole organisation, not per workspace, because a question costs the same vendor spend whichever brand it sits under.

## Query parameters

- `brand` string

## Response `200`

OK

- object
  - `data` Question[], required
    - `id` string, required: Public id.
    - `text` string, required
    - `category` string, nullable, required
    - `source` string, required: How the question got here, for example user or suggested.
    - `active` boolean, required: Inactive questions stop being run but keep the answers they already produced.
    - `answers` integer, required: Answers this question has produced in total, all engines.
    - `answers_naming_you` integer, required
    - `web_search_volume` integer, nullable, required: NULL MEANS NOT CHECKED, not zero. Reporting an unchecked volume as 0 asserts nobody searches a question nobody has measured. Read volume_checked_at before quoting demand.
    - `volume_checked_at` string, date-time, nullable, required: When volume was last looked up. Null when it never has been.
  - `meta` object, required
    - `generated_at` string, date-time
    - `brand` BrandRef: Which brand a response describes. Present in meta on every data endpoint.
      - `id` string, required: Pass as ?brand=.
      - `name` string, required: Display name.
    - `note` string
    - `questions_allowed` integer: The plan's cap on active questions, organisation-wide.
    - `questions_used` integer
    - `questions_remaining` integer: Zero means another question cannot be added on this plan.

## Other responses

- `400`: brand_required, or a cursor that does not belong to this brand.
- `401`: Missing, malformed, revoked or expired key.
- `402`: The organisation has never subscribed, or the plan excludes the API.
- `403`: The key lacks the required scope.
- `404`: No such brand, or the brand has not finished setup.
- `429`: Rate limit exceeded. Carries Retry-After.

---

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