DAdatadome
Feedback

Lists detection feedback reports

Lists the reports on your account, newest first, ordered by createdAt descending.

Paging is by cursor. Read meta.nextCursor and send it back as cursor. On the last page the key is absent rather than null, so test for its presence. There are no page or offset parameters.

All filters are optional and combine with AND. Unknown query parameters are ignored rather than rejected, so check the spelling of a filter that appears to have no effect. Reports older than six months are not returned, whatever createdAfter asks for.

There is no account parameter: results are always scoped to the API key you authenticate with.

get/1.1/feedback

Request

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

Query parameters

limitinteger

How many reports to return. A whole number between 1 and 100; a decimal is rejected.

cursorstring

The meta.nextCursor value from the previous page. Omit it to start at the newest report. A cursor that cannot be decoded is rejected with 400.

createdAfterstring date-time

Only reports submitted at or after this instant. ISO-8601 with a timezone offset. Values older than six months are silently raised to the six month floor.

createdBeforestring date-time

Only reports submitted before this instant, exclusive. ISO-8601 with a timezone offset.

entityType'ip' | 'requestId' | 'sessionId' | 'userId'

Only reports scoped to this kind of identifier.

entityIdstring

Only reports whose scope contains this identifier. Requires entityType; sent alone it is rejected with 400.

timeWindowFromstring date-time

Start of the interval the report's own time window must overlap. Must be sent together with timeWindowTo.

timeWindowTostring date-time

End of that interval, exclusive, forming the half-open interval [timeWindowFrom, timeWindowTo). Must be strictly after timeWindowFrom, and must be sent together with it. A report matches when its stored start is before timeWindowTo and its stored end is at or after timeWindowFrom.

feedbackType'falsePositive' | 'falseNegative'

Only reports of this type.

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

Only reports in this state.

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

Only reports of this severity.

origin'manualReview' | 'chargebacks' | 'automatedRule' | 'dashboard' | 'datadome' | 'other'

Only reports submitted with this origin.

trafficFilterstring

Only reports whose stored traffic filter contains this text. A substring match over the query you submitted, not a query of your traffic. * and ? are matched literally. An empty or whitespace-only value is treated as not supplied.

Response

One page of reports, newest first.

Example response

{
  "data": [
    {
      "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.