--- updatedAt: 2026-08-12T16:23:16.000Z agentTools: siteIndex: https://techdocs.akamai.com/llms.txt projectIndex: https://techdocs.akamai.com/application-security/llms.txt --- # Translate an error reference code Returns a summary of the specified error so you can investigate why a request was blocked. You can look up an Akamai error reference code from the past 31 days, # OpenAPI definition ```json { "externalDocs": { "description": "See documentation for Akamai's Application Security API", "url": "https://techdocs.akamai.com/application-security/reference" }, "info": { "license": { "name": "Apache 2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0.html" }, "title": "Utilities and account data", "version": "v1" }, "openapi": "3.0.0", "paths": { "/error-translator/{errorReferenceCode}": { "get": { "description": "Returns a summary of the specified error so you can investigate why a request was blocked. You can look up an Akamai error reference code from the past 31 days, ", "externalDocs": { "description": "See documentation for this operation in Akamai's Application Security API", "url": "https://techdocs.akamai.com/application-security/reference/get-error-translator-lookup" }, "operationId": "get-error-translator-lookup", "parameters": [ { "description": "For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys).", "in": "query", "name": "accountSwitchKey", "required": false, "schema": { "example": "1-5C0YLB:1-8BYUX", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "errorReferenceCode": "18.713f12c6.1782371012.6acdf833", "failureReasonCategories": [ "DOS", "BOT", "WAF" ], "requestInfo": { "asn": "63949", "connectingIp": "10.242.4.46", "countryCode": "US", "status": 200, "url": "http://www.hmapi.com/page.php" }, "securityInfo": { "configId": "14227", "configName": "WAF Security File", "configVersion": 295, "configVersionLink": "/appsec/v1/configs/14227/versions/295", "policyId": "qik1_26545", "policyLink": "/appsec/v1/configs/14227/versions/295/security-policies/qik1_26545" }, "timestamp": "2026-06-25T07:03:32Z", "wsaInfo": { "resultUrl": "https://control.akamai.com/apps/security-analytics/#/?accountId=B-C-SWLYWC&configSelector=14227&startTime=1782367412000&endTime=1782374612000&filters=%5B%5B%22in%22%2C%22request_id%22%2C%5B%226acdf833%22%5D%2Ctrue%5D%5D&selectedView=samples&eval=off&fmode=request" } }, "schema": { "additionalProperties": false, "description": "Contains the security event diagnostics for a translated error reference code.", "properties": { "errorReferenceCode": { "description": "The error reference code that identifies the security event.", "type": "string" }, "failureReasonCategories": { "description": "The security protections categories used in blocking the request. Either `WAF`, `BOT`, `MALWARE_PROTECTION`, `UNCLASSIFIED`, `CUSTOM_RULE`, `USER_RISK`, `DOS`, `REPUTATION`, `NETWORK_LIST` or `WAF_EVALUATION`.", "items": { "description": "\n
\n\nShow details on supported values\n\n\n
", "enum": [ "WAF", "BOT", "MALWARE_PROTECTION", "UNCLASSIFIED", "CUSTOM_RULE", "USER_RISK", "DOS", "REPUTATION", "NETWORK_LIST", "WAF_EVALUATION" ], "type": "string", "x-akamai": { "enum-descriptions": { "BOT": "The request was blocked by Bot Manager.", "CUSTOM_RULE": "The request was blocked by a custom rule.", "DOS": "The request was blocked by Denial of Service (DoS) protections.", "MALWARE_PROTECTION": "The request was blocked by Malware Protection.", "NETWORK_LIST": "The request was blocked by Network List protections.", "REPUTATION": "The request was blocked by client reputation protections.", "UNCLASSIFIED": "The request was blocked by a protection not classified into the other categories.", "USER_RISK": "The request was blocked by Account Protector's User Risk protections.", "WAF": "The request was blocked by Web Application Firewall (WAF) protections.", "WAF_EVALUATION": "The request was blocked by evaluation rules." } } }, "minItems": 0, "type": "array" }, "requestInfo": { "additionalProperties": false, "description": "Details about the end user's request that triggered the security event.", "properties": { "asn": { "description": "The Autonomous System Number (ASN) for the connecting IP address.", "type": "string" }, "connectingIp": { "description": "The IP address that the request originated from.", "type": "string" }, "countryCode": { "description": "The two-letter ISO 3166 country code where the request originated from.", "type": "string" }, "status": { "description": "The HTTP status code returned for the request.", "type": "integer" }, "url": { "description": "The URL of the request.", "type": "string" } }, "type": "object" }, "securityInfo": { "additionalProperties": false, "description": "Details about the security configuration and policy that processed the request.", "properties": { "configId": { "description": "Uniquely identifies the security configuration.", "type": "string" }, "configName": { "description": "The name of the security configuration.", "type": "string" }, "configVersion": { "description": "The version of the security configuration.", "type": "integer" }, "configVersionLink": { "description": "A hypermedia link to the security configuration version.", "type": "string" }, "policyId": { "description": "Uniquely identifies the security policy.", "type": "string" }, "policyLink": { "description": "A hypermedia link to the security policy.", "type": "string" } }, "type": "object" }, "timestamp": { "description": "The time when the security event occurred.", "format": "date-time", "type": "string" }, "wsaInfo": { "additionalProperties": false, "description": "Details that link to the Web Security Analytics (WSA) data for the security event.", "properties": { "resultUrl": { "description": "A link to the Web Security Analytics (WSA) view for the security event.", "type": "string" } }, "type": "object" } }, "required": [ "errorReferenceCode", "timestamp" ], "type": "object", "x-akamai": { "file-path": "schemas/error-translator-detail-get.yaml" } } } }, "description": "Successful response." }, "400": { "content": { "application/problem+json": { "example": { "detail": "The provided error reference code is invalid or not associated with a security event.", "instance": "https://problems.luna.akamaiapis.net/appsec/error-instances/2022ccbd25da0b72", "status": 400, "title": "Invalid Input", "type": "https://problems.luna.akamaiapis.net/appsec/error-types/INVALID-INPUT" }, "schema": { "additionalProperties": true, "description": "Details the errors you can receive.", "properties": { "detail": { "description": "The detailed error message.", "type": "string" }, "fieldErrors": { "description": "Pointers to fields for which invalid input was provided, whose values are messages detailing the reason this input was invalid for this field.", "type": "object" }, "instance": { "description": "The non-referenceable URI that indicates the error instance.", "example": "https://problems.luna.akamaiapis.net/api-definitions/error-instances/d54686b5-21cb-4ab7-a8d6-a92282cf1749", "type": "string" }, "status": { "description": "The HTTP status code.", "example": 404, "type": "integer" }, "title": { "description": "The error title.", "example": "Not Found", "type": "string" }, "type": { "description": "The URL for the error type.", "example": "https://problems.luna.akamaiapis.net/api-definitions/error-types/NOT-FOUND", "type": "string" } }, "required": [ "title", "type", "detail", "instance", "status" ], "type": "object", "x-akamai": { "file-path": "schemas/problem-details.yaml" } } } }, "description": "[Invalid](https://techdocs.akamai.com/application-security/reference/400). Client error, such as invalid or malformed input." }, "404": { "content": { "application/problem+json": { "example": { "detail": "No security event data was found for the provided error reference code.", "instance": "https://problems.luna.akamaiapis.net/appsec/error-instances/4279c6e2610889b7", "status": 404, "title": "Not Found", "type": "https://problems.luna.akamaiapis.net/appsec/error-types/NOT-FOUND" }, "schema": { "additionalProperties": true, "description": "Details the errors you can receive.", "properties": { "detail": { "description": "The detailed error message.", "type": "string" }, "fieldErrors": { "description": "Pointers to fields for which invalid input was provided, whose values are messages detailing the reason this input was invalid for this field.", "type": "object" }, "instance": { "description": "The non-referenceable URI that indicates the error instance.", "example": "https://problems.luna.akamaiapis.net/api-definitions/error-instances/d54686b5-21cb-4ab7-a8d6-a92282cf1749", "type": "string" }, "status": { "description": "The HTTP status code.", "example": 404, "type": "integer" }, "title": { "description": "The error title.", "example": "Not Found", "type": "string" }, "type": { "description": "The URL for the error type.", "example": "https://problems.luna.akamaiapis.net/api-definitions/error-types/NOT-FOUND", "type": "string" } }, "required": [ "title", "type", "detail", "instance", "status" ], "type": "object", "x-akamai": { "file-path": "schemas/problem-details.yaml" } } } }, "description": "[Not found](https://techdocs.akamai.com/application-security/reference/404). The requested resource could not be found." }, "500": { "content": { "application/problem+json": { "example": { "detail": "Internal Server Error", "instance": "12ab3c45-789d-01ef-2gh3-ijk4l56m78no", "status": 500, "title": "Internal Server Error", "type": "internal_server_error" }, "schema": { "additionalProperties": true, "description": "Details the errors you can receive.", "properties": { "detail": { "description": "The detailed error message.", "type": "string" }, "fieldErrors": { "description": "Pointers to fields for which invalid input was provided, whose values are messages detailing the reason this input was invalid for this field.", "type": "object" }, "instance": { "description": "The non-referenceable URI that indicates the error instance.", "example": "https://problems.luna.akamaiapis.net/api-definitions/error-instances/d54686b5-21cb-4ab7-a8d6-a92282cf1749", "type": "string" }, "status": { "description": "The HTTP status code.", "example": 404, "type": "integer" }, "title": { "description": "The error title.", "example": "Not Found", "type": "string" }, "type": { "description": "The URL for the error type.", "example": "https://problems.luna.akamaiapis.net/api-definitions/error-types/NOT-FOUND", "type": "string" } }, "required": [ "title", "type", "detail", "instance", "status" ], "type": "object", "x-akamai": { "file-path": "schemas/problem-details.yaml" } } } }, "description": "[Internal server error](https://techdocs.akamai.com/application-security/reference/500). Something went wrong on our side. Try again in a few minutes or contact support if the error persists.", "x-akamai": { "file-path": "errors/500-server-errors.yaml" } } }, "summary": "Translate an error reference code", "tags": [ "Error code translator" ] }, "parameters": [ { "description": "A unique error reference code that identifies a specific security event. End users encounter this code when their request is blocked, and you use it to look up the corresponding security event diagnostics.", "in": "path", "name": "errorReferenceCode", "required": true, "schema": { "example": "18.713f12c6.1782371012.6acdf833", "type": "string" }, "x-akamai": { "file-path": "parameters/error-reference-code-path.yaml" } } ], "x-akamai": { "file-path": "paths/error-translator.yaml", "path-info": "/error-translator/{errorReferenceCode}" } } }, "servers": [ { "url": "https://{hostname}/appsec/v1" } ], "x-akamai": { "auth-type": "EDGE_GRID", "file-path": "05-utilities-and-account-data.yaml" }, "x-readme": { "explorer-enabled": false, "samples-languages": [ "curl", "python", "node" ] } } ```