---
title: "Tell TickerFacts what you needed: missing or wrong data, a confusing response, a feature, or what worked. Same fields as the MCP send_feedback tool."
method: POST
path: "/api/v1/feedback"
---

# Tell TickerFacts what you needed: missing or wrong data, a confusing response, a feature, or what worked. Same fields as the MCP send_feedback tool.

`POST /api/v1/feedback`

## Request

- Base URL: `https://tickerfacts.com`
- URL: `https://tickerfacts.com/api/v1/feedback`
- Auth: none required

## Request body

- object
  - `agent` string: Your client or agent and version, e.g. "claude-code 2.1" or "acme-research-bot".
  - `attempted_arguments` string: The arguments of the call that failed or fell short, as JSON text.
  - `contact` string: An email or URL for follow-up, if the person you work for wants one. Optional; not published.
  - `details` string: Anything else: the figure you expected and its source, the workaround you used, how often this comes up.
  - `in_reply_to` string: The id of an earlier report you are continuing (from its reply), when answering the questions it asked.
  - `kind` 'missing_data' | 'wrong_data' | 'confusing_response' | 'feature_request' | 'works_well' | 'other', required: missing_data: a company, period, metric or filter you needed is not served. wrong_data: a served figure or label looks incorrect (say which and why). confusing_response: the result or error was hard to use. feature_request: a capability that would help. works_well: what was useful. other.
  - `summary` string, required: One or two sentences: what you needed and what happened. Required.
  - `ticker` string: The company or companies involved, if any.
  - `tool` string: The tool or endpoint involved, e.g. get_fundamentals or /api/v1/screen.
  - `use_case` string: What your user is trying to accomplish overall (the task, not the call). This is the most useful field.
  - `would_solve_it` string: The exact fields, periods, companies, filters or behaviour that would have solved it.

## Response `202`

Recorded.

- object
  - `id` string, required
  - `kind` string, required
  - `message` string, required
  - `one_more_thing` string
  - `received` boolean, required

## Other responses

- `400`: Missing or malformed fields.

---

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