---
title: "Submit feedback on an incentive record"
method: POST
path: "/incentives/feedback"
tags: ["Incentives"]
---

# Submit feedback on an incentive record

`POST /incentives/feedback`

Customers and partners report data quality issues — wrong amount, expired program, missing program, etc. Feedback is queued internally for review.

At least one of `canonical_id`, `ongoing_id`, or `user_message` must be provided so we can act on the report.

## Request body

- object
  - `canonical_id` integer — ID of an upfront program from the /incentives response (preferred when reporting on a specific record)
  - `ongoing_id` integer — ID of an ongoing program from the /incentives response
  - `feedback_type` 'wrong_amount' | 'expired' | 'missing' | 'wrong_tech' | 'wrong_provider' | 'other', required — - `wrong_amount`: amount shown is incorrect - `expired`: program is no longer available - `missing`: there's an incentive we're not surfacing - `wrong_tech`: program is listed under wrong product category - `wrong_provider`: provider name or link is wrong - `other`: free-form (must include user_message)
  - `user_message` string — Free-form description (required when feedback_type is `other` or when no record id is provided)
  - `zipcode` string
  - `utility_eid` integer
  - `state` string
  - `tech_key` string — e.g. "heat_pump", "solar"
  - `displayed_amount` string — What the customer saw in our response, e.g. "$1,000"
  - `displayed_program` string
  - `suggested_amount` string — What the customer thinks is correct
  - `suggested_url` string, uri — Authority page URL with the correct data

## Response `201`

Feedback recorded

- object
  - `status` string
  - `feedback_id` string
  - `message` string

## Other responses

- `400` — Validation error
- `500` — Internal server error

---

[API](https://skmtc.net/wattbuy/apis/wattbuy-apis.md) · [All operations](https://skmtc.net/wattbuy/apis/wattbuy-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wattbuy/wattbuy-apis/revisions/97771153b652/schema)
