Feedback

Gets a detection feedback report

Returns one report, including the analysts' conclusion in comment once status is completed. Poll this operation, or the search operation, to follow a report to its verdict.

get/1.1/feedback/{feedbackId}

Request

  • Base URL
    https://customer-api.datadome.co
  • URL
    https://customer-api.datadome.co/1.1/feedback/{feedbackId}
  • Auth
    API key in header x-api-key

Path parameters

feedbackIdstring uuid required

The feedbackId returned when the report was submitted.

Response

The report.

feedbackIdstring uuid

Identifier of the report. Use it to retrieve or cancel the report.

customerIdinteger

The account the report belongs to, taken from the API key you submitted it with.

status'pending' | 'processing' | 'completed' | 'canceled'

Where the report is in our review. A new report is always pending. Only a pending report can be canceled.

feedbackType'falsePositive' | 'falseNegative'

What the detection got wrong. falsePositive reports legitimate traffic that was challenged or blocked. falseNegative reports unwanted traffic that was allowed through.

severity'low' | 'medium' | 'high' | 'critical'

The severity you submitted, or medium when you omitted it.

originstring nullable

The origin you submitted, or null.

originIdstring nullable

The identifier you submitted, or null.

createdAtstring date-time

When we received the report. ISO-8601 with millisecond precision.

completedAtstring date-time nullable

When our review finished. null until the status is completed, and null for a canceled report.

commentstring nullable

What our analysts concluded. null until the review is complete. You cannot set this field.

feedbackReasonstring nullable

The explanation you submitted, or null.

expectedDecisionstring nullable

Reserved for a future use. Always null, and a request that sets it is rejected. Present only so that clients deserializing the full response do not meet an undeclared field.

Example response

{
  "createdAt": "2026-08-26T09:14:32.118+00:00",
  "timeWindow": {
    "start": "2026-08-25T08:00:00+00:00",
    "end": "2026-08-25T09:00:00+00:00"
  },
  "scope": {
    "trafficFilter": "countrycode:FR"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.