---
title: "Send feedback or a data request (free, no key needed)"
method: POST
path: "/api/v1/feedback"
---

# Send feedback or a data request (free, no key needed)

`POST /api/v1/feedback`

## Request

- Base URL: `https://invokely.ai`
- URL: `https://invokely.ai/api/v1/feedback`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`
  - none

Send a message to the Invokely team. Call it when the user asks for a statistic, place, source or period Invokely does not have (kind "data_request"), when a value looks wrong (kind "data_error", with the indicator, place and period in refs), when the user wants to suggest something ("suggestion"), or reports a problem with Invokely itself ("bug"). Then tell the user it was sent.
Write the message in plain words: what is missing or wrong and why it matters to the user. Do not include personal data beyond what the user asks you to pass on.
Examples: {"kind": "data_request", "message": "Monthly house prices for Portuguese municipalities, from INE Portugal.", "refs": {"place": "Portugal", "source": "INE Portugal"}}. {"kind": "data_error", "message": "The 2024 value is ten times the 2023 value; the BLS release shows 4.1.", "refs": {"indicator": "unemployment_rate", "place": "us-48", "period": "2024", "url": "https://www.bls.gov/"}}.
Free on every plan and without an account; it does not use the monthly allowance. Up to 10 messages an hour per account, 5 without one. Returns {feedback: {id, kind, status, created_at}, note}.

## Request body

- object
  - `kind` 'data_request' | 'data_error' | 'suggestion' | 'bug' | 'other', required: "data_request": data Invokely lacks. "data_error": a value that looks wrong. "suggestion", "bug" or "other".
  - `message` string, required: What the user wants or what looks wrong, in plain text.
  - `refs` object: Optional references that make the message actionable.
    - `indicator` string: Indicator id, for example "unemployment_rate", or the name of a statistic Invokely lacks.
    - `place` string: Place name or id, for example "Texas" or "es-mun-08121".
    - `source` string: Source id or publisher name.
    - `period` string: Period, for example "2024", "2024-Q3" or "2024-09".
    - `url` string: An http or https link: the publisher page with the right figure, or the Invokely page with the problem.
  - `contact_email` string: Optional, only when the user asks to be contacted and is not signed in: an address the team may reply to. Signed-in users are answered at their account address.

## Response `201`

{"data": {"feedback": {id, kind, status, created_at}, "note"}}

- Data
  - `data` unknown, required

## Other responses

- `400`: Invalid argument (INVALID_ARGUMENT).
- `401`: The API key is invalid or revoked (UNAUTHORIZED).
- `429`: Too many messages this hour (RATE_LIMITED).

---

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