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

# Submit feedback on an incentive record

`POST /incentives/feedback`

## Request

- Base URL: `https://apis.wattbuy.com/v3`
- URL: `https://apis.wattbuy.com/v3/incentives/feedback`
- Auth: API key in header `x-api-key`

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.dev/wattbuy/apis/wattbuy-apis.md) - [All operations](https://skmtc.dev/wattbuy/apis/wattbuy-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/wattbuy/apis/wattbuy-apis/revisions/443ce1657edb?raw)
