Sending Feedback

19 May 2025

    POST https://signals.gse.live/report /feedback

    Send feedback for signals

    Bulk reporting of feedback on signals

    Payload Attributes

    Required attributes

    • Name
      signal
      Type
      mediumstring
      Description
      The signal you want to share.
    • Name
      report_date
      Type
      datetime
      Description
      Date & time the signal was reported.
    • Name
      abuse_type
      Type
      string
      Description
      The type of abuse this signal represents. Must be one of the following types...

      If you would like to send us a different abuse type, please contact us.


      Loading options....

    Optional attributes

    • Name
      mitigated
      Type
      boolean
      Description
      Was this signal mitigated.
    • Name
      mitigation_date
      Type
      datetime
      Description
      Date and time the signal was mitigated.
    • Name
      mitigation_action
      Type
      string
      Description
      The type of action that was taken to mitigate this signal.
    • Name
      mitigation_action_other
      Type
      string
      Description
      Additional information relating to the mitigation of the signal.
    • Name
      accuracy
      Type
      integer
      Description
      On a scale of 1-10, how accurate was the report.
    • Name
      accuracy_reason
      Type
      string
      Description
      Additional information relating to the accuracy of the report.
    • Name
      accuracy_reason_other
      Type
      string
      Description
      Additional information.
    • Name
      useful
      Type
      string
      Description
      How useful was the reported signals.
    • Name
      useful_information
      Type
      string
      Description
      Additional information relating to the usefulness of the signal.
    • Name
      role
      Type
      string
      Description
      The role of the entity providing the feedback eg. Law Enforcement, Government, Managing Registrar, Managing Registry...
    • Name
      feedback_date
      Type
      datetime
      Description
      The date and time the feedback was provided

    Response Attributes

    • Name
      adds
      Type
      number
      Description
    • Name
      updates
      Type
      number
      Description
    • Name
      replaces
      Type
      number
      Description
    • Name
      deletes
      Type
      number
      Description
    • Name
      rejected
      Type
      number
      Description
    • Name
      validationErrors
      Type
      array
      Description

      It will only appear if rejected's value is 1

    Request

    POST · /feedback
curl -X POST https://signals.gse.live/report/feedback \
-H "API-KEY: YOUR-API-KEY-HERE" \
-H "API-SECRET: YOUR-API-SECRET-HERE" \

    Payload

    [
  {
    "signal": "https://somesignal.com",
    "report_date": "2020-01-23 14:24:06",
    "abuse_type": "phishing",
    "mitigated": "true",
    "mitigation_date": "2025-04-23 10:24:06",
    "mitigation_action": "clienthold",
    "mitigation_action_other": "null",
    "accuracy": "10",
    "accuracy_reason": "null",
    "accuracy_reason_other": "null",
    "useful": "10",
    "useful_information": "null",
    "role": "Managing Registrar",
    "feedback_date": "2025-04-23 14:20:06"
  },
  // ...
]

    Response

    [
  {
    "adds": "1",
    "updates": "0",
    "replaces": "0",
    "deletes": "0",
    "rejected": "0",
    "validationErrors": "[]"
  },
  // ...
]