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": "[]"
      },
      // ...
    ]