GoDaddy’s Abuse API is provided to simplify and standardize the abuse reporting experience. To help us streamline the review of abuse reports, you acknowledge and agree that your use of GoDaddy’s Abuse API is subject to the following quality metrics and terms of use.
GoDaddy may, in its sole and absolute discretion, change or modify these terms, and such changes or modifications shall be effective immediately upon notice to you. Your use of GoDaddy’s Abuse API after such changes or modifications shall constitute your acceptance of these terms as last revised. If you do not agree to be bound by these terms as last revised, do not use (or continue to use) our Abuse API.
As an Abuse API user, you must only submit abuse reports via the API portal and cease all email submissions, including but not limited, to phishing@godaddy.com, netabuse@godaddy.com, malware@godaddy.com, or spam@godaddy.com, etc. Any additional or duplicate submission outside of the API portal will be deprioritized for review. Submissions related to trademark, copyright or content issues may still be sent to trademarkclaims@godaddy.com, coyprightclaims@godaddy.com, and contentcomplaints@godaddy.com, respectively. Our [Front of Site](https://supportcenter.godaddy.com/AbuseReport) also describes other scenarios not covered by the API.
When you submit abuse reports via GoDaddy’s Abuse API, you must ensure that you accurately categorize the abuse type of each report to match our definitions in the API documentations provided to you. Any submission that fails to match our definitions or is miscategorized will be marked as a false positive. Examples include, but are not limited to, submissions of trademark complaints marked as phishing or malware, or submissions of copyright complaints marked as phishing or malware, etc.
If, at any time, the false positive rate of submissions exceeds 40% of your total submissions, as determined by GoDaddy, GoDaddy may in its sole discretion deprioritize any subsequent reports submitted by you and/or your organization.
You acknowledge and agree that submitting every URL for a single domain is not necessary and will not expedite the review process. If your submissions exceed five (5) URLs for a single domain, your report will be marked as a duplicate submission taking into account that the final outcome of such submissions would yield the same result as the original report. GoDaddy may in its sole discretion deprioritize reports submitted by you and/or your organization in the event more than 20% of your submissions are classified as duplicate submissions.
You further acknowledge and agree that our Customer Support lines are not intended to address abuse reporting matters or your use of GoDaddy’s Abuse API. Contacting Customer Support will not expedite the review process and may result in abuse reports being deprioritized, to be determined in our sole discretion.
Should you have any questions about GoDaddy’s Abuse API or any of the terms and conditions set forth above, please contact abuseapisupport@godaddy.com.
" }, "tags": [ { "name": "v1", "description": "" }, { "name": "v2", "description": "An incremental update that keeps the endpoints largely the same, but deprecates some commonly misused parameters and add some features to ensure reports can be worked quicker." } ], "host": "api.ote-godaddy.com", "paths": { "/v1/abuse/tickets": { "get": { "tags": [ "v1" ], "parameters": [ { "description": "The type of abuse.", "enum": [ "A_RECORD", "CHILD_ABUSE", "CONTENT", "FRAUD_WIRE", "IP_BLOCK", "MALWARE", "NETWORK_ABUSE", "PHISHING", "SPAM" ], "in": "query", "name": "type", "required": false, "type": "string" }, { "default": false, "description": "Is this abuse ticket closed?", "in": "query", "name": "closed", "required": false, "type": "boolean" }, { "description": "The domain name or ip address the abuse originated from", "format": "host-name-or-ip-address", "in": "query", "name": "sourceDomainOrIp", "required": false, "type": "string" }, { "description": "The brand/company the abuse is targeting. ie: brand name/bank name", "in": "query", "name": "target", "required": false, "type": "string" }, { "description": "The earliest abuse ticket creation date to pull abuse tickets for", "format": "iso-datetime", "in": "query", "name": "createdStart", "required": false, "type": "string" }, { "description": "The latest abuse ticket creation date to pull abuse tickets for", "format": "iso-datetime", "in": "query", "name": "createdEnd", "required": false, "type": "string" }, { "default": 100, "description": "Number of abuse ticket numbers to return.", "format": "integer-positive", "in": "query", "maximum": 100, "name": "limit", "required": false, "type": "integer" }, { "default": 0, "description": "The earliest result set record number to pull abuse tickets for", "format": "integer-positive", "in": "query", "name": "offset", "required": false, "type": "integer" } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/AbuseTicketList" } }, "401": { "description": "Authentication info not sent or invalid", "schema": { "$ref": "#/definitions/Error" } }, "403": { "description": "Authenticated user is not allowed access", "schema": { "$ref": "#/definitions/Error" } }, "422": { "description": "Error", "schema": { "$ref": "#/definitions/Error" } } }, "operationId": "getTickets", "summary": "List all abuse tickets ids that match user provided filters" }, "post": { "tags": [ "v1" ], "parameters": [ { "description": "The endpoint which allows the Reporter to create a new abuse ticket", "in": "body", "name": "body", "required": true, "schema": { "$ref": "#/definitions/AbuseTicketCreateLegacy" } } ], "responses": { "201": { "description": "Success", "schema": { "$ref": "#/definitions/AbuseTicketId" } }, "401": { "description": "Authentication info not sent or invalid", "schema": { "$ref": "#/definitions/Error" } }, "403": { "description": "Authenticated user is not allowed access", "schema": { "$ref": "#/definitions/Error" } }, "422": { "description": "Error", "schema": { "$ref": "#/definitions/Error" } } }, "operationId": "createTicket", "summary": "Create a new abuse ticket" } }, "/v1/abuse/tickets/{ticketId}": { "get": { "tags": [ "v1" ], "parameters": [ { "description": "A unique abuse ticket identifier", "in": "path", "name": "ticketId", "required": true, "type": "string" } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/AbuseTicketLegacy" } }, "401": { "description": "Authentication info not sent or invalid", "schema": { "$ref": "#/definitions/Error" } }, "403": { "description": "Authenticated user is not allowed access", "schema": { "$ref": "#/definitions/Error" } }, "404": { "description": "Invalid ticket id provided", "schema": { "$ref": "#/definitions/Error" } } }, "operationId": "getTicketInfo", "summary": "Return the abuse ticket data for a given ticket id" } }, "/v2/abuse/tickets": { "get": { "tags": [ "v2" ], "parameters": [ { "description": "The type of abuse.", "enum": [ "A_RECORD", "CHILD_ABUSE", "CONTENT", "FRAUD_WIRE", "IP_BLOCK", "MALWARE", "NETWORK_ABUSE", "PHISHING", "SPAM" ], "in": "query", "name": "type", "required": false, "type": "string" }, { "default": false, "description": "Is this abuse ticket closed?", "in": "query", "name": "closed", "required": false, "type": "boolean" }, { "description": "The domain name or ip address the abuse originated from", "format": "host-name-or-ip-address", "in": "query", "name": "sourceDomainOrIp", "required": false, "type": "string" }, { "description": "The brand/company the abuse is targeting. ie: brand name/bank name", "in": "query", "name": "target", "required": false, "type": "string" }, { "description": "The earliest abuse ticket creation date to pull abuse tickets for", "format": "iso-datetime", "in": "query", "name": "createdStart", "required": false, "type": "string" }, { "description": "The latest abuse ticket creation date to pull abuse tickets for", "format": "iso-datetime", "in": "query", "name": "createdEnd", "required": false, "type": "string" }, { "default": 100, "description": "Number of abuse ticket numbers to return.", "format": "integer-positive", "in": "query", "maximum": 100, "name": "limit", "required": false, "type": "integer" }, { "default": 0, "description": "The earliest result set record number to pull abuse tickets for", "format": "integer-positive", "in": "query", "name": "offset", "required": false, "type": "integer" } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/AbuseTicketList" } }, "401": { "description": "Authentication info not sent or invalid", "schema": { "$ref": "#/definitions/Error" } }, "403": { "description": "Authenticated user is not allowed access", "schema": { "$ref": "#/definitions/Error" } }, "422": { "description": "Error", "schema": { "$ref": "#/definitions/Error" } } }, "operationId": "getTicketsV2", "summary": "List all abuse tickets ids that match user provided filters" }, "post": { "tags": [ "v2" ], "parameters": [ { "description": "The endpoint which allows the Reporter to create a new abuse ticket", "in": "body", "name": "body", "required": true, "schema": { "$ref": "#/definitions/AbuseTicketCreate" } } ], "responses": { "201": { "description": "Success", "schema": { "$ref": "#/definitions/AbuseTicketId" } }, "401": { "description": "Authentication info not sent or invalid", "schema": { "$ref": "#/definitions/Error" } }, "403": { "description": "Authenticated user is not allowed access", "schema": { "$ref": "#/definitions/Error" } }, "422": { "description": "Error", "schema": { "$ref": "#/definitions/Error" } } }, "operationId": "createTicketV2", "summary": "Create a new abuse ticket" } }, "/v2/abuse/tickets/{ticketId}": { "get": { "tags": [ "v2" ], "parameters": [ { "description": "A unique abuse ticket identifier", "in": "path", "name": "ticketId", "required": true, "type": "string" } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/AbuseTicket" } }, "401": { "description": "Authentication info not sent or invalid", "schema": { "$ref": "#/definitions/Error" } }, "403": { "description": "Authenticated user is not allowed access", "schema": { "$ref": "#/definitions/Error" } }, "404": { "description": "Invalid ticket id provided", "schema": { "$ref": "#/definitions/Error" } } }, "operationId": "getTicketInfoV2", "summary": "Return the abuse ticket data for a given ticket id" } } }, "definitions": { "AbuseTicketLegacy": { "description": "The associated fields returned, given a unique abuse ticket id", "properties": { "closed": { "default": false, "description": "Is this abuse ticket closed?", "type": "boolean" }, "closedAt": { "description": "The date the abuse ticket was closed", "format": "iso-datetime", "type": "string" }, "createdAt": { "description": "The date the abuse ticket was created", "format": "iso-datetime", "type": "string" }, "domainIp": { "description": "The domain or IP the suspected abuse was reported against", "type": "string" }, "reporter": { "description": "The shopper id of the person who reported the suspected abuse", "type": "string" }, "source": { "description": "The single URL or IP the suspected abuse was reported against", "type": "string" }, "target": { "description": "The company the suspected abuse is targeting", "type": "string" }, "ticketId": { "description": "Abuse ticket ID", "type": "string" }, "type": { "description": "The type of abuse being reported", "enum": [ "A_RECORD", "CHILD_ABUSE", "CONTENT", "FRAUD_WIRE", "IP_BLOCK", "MALWARE", "NETWORK_ABUSE", "PHISHING", "SPAM" ], "type": "string" } }, "required": [ "ticketId", "reporter", "domainIp", "closed", "type", "target", "source", "createdAt", "closedAt" ] }, "AbuseTicket": { "allOf": [ { "$ref": "#/definitions/AbuseTicketLegacy" }, { "type": "object", "properties": { "closeReason": { "description": "The reason that the ticket was closed.