Server Errors

Availability

Use of the production Forward API is subject to eligibility.

Contact your Account Manager for more information or submit an inquiry to our Business Development team.

Server errors are returned when the Forward API is unable to complete the request. The body is a JSON structure with a format resembling the following example:

json

{
    "error": "Connect timeout",
    "message": {
        "server_error?": true,
        "connect_timeout": 10000
    },
    "request-uuid": "a-unique-identifier-for-the-request"
}

Error	Explanation	Additional `message` fields	HTTP Status Code
Connect timeout	Time establishing a TCP connection to the destination exceeded the configured threshold	`connect_timeout`	504
Request timeout	Elapsed time processing request exceeded the configured threshold	`request_timeout`	504
Socket timeout	Time between packets exceeded the configured threshold	`socket_timeout`	504
TLS error	The TLS handshake with the destination API failed		502

Note

If the destination returns a 5xx error, the Forward API response will have a status code of 200, but the response body will show the destination's response error in the status field.