Fluent Commerce Logo
Docs
Sign In

REST API Error Codes Overview

Essential knowledge

Authors:

Holger Lierse, Kirill Gaiduk

Changed on:

26 May 2025

Overview

Fluent REST API specific HTTP Error Codes which may vary depending on the API endpoint and are explained in this document.

Key points

  • Categorization by HTTP Status Code: The errors are organized by standard HTTP status codes (e.g., 400, 401, 403, etc.), which helps developers quickly understand the type of issue
  • Coverage of Common Scenarios: The examples span a range of typical failure conditions, from authentication issues to plugin errors and timeouts, offering a practical reference for API consumers

REST API Error Codes Examples

The Error Code examples returned by the Fluent REST API are provided below.

Error Code: 400 Examples

Invalid Credentials
1{
2    "error": "invalid_grant",
3    "error_description": "Bad credentials"
4}
Missing Name
1{
2    "errors": [
3        {
4            "code": "400",
5            "message": "'name' is required"
6        }
7    ]
8}
Invalid JAR file
1{
2    "message": "\"tmpfile\" is not a valid JAR file",
3    "status": 400
4}
FAILED Event
1{
2    "eventId": "74d61610-1f0f-11eb-9c14-f349e6caa9d2",
3    "entityId": "107",
4    "eventStatus": "FAILED",
5    "errorMessage": "Event has Failed"
6}
NO_MATCH Event
1{
2    "eventId": "a0a63630-1f0f-11eb-84d4-45738fb94811",
3    "entityId": "214",
4    "eventStatus": "NO_MATCH"
5}
Missing Retailer
1{
2    "errors": [
3        {
4            "code": "NotNull",
5            "message": "'retailerId' is required"
6        }
7    ]
8}

Error Code: 401 Examples

Missing Retailer
1{
2    "errors": [
3        {
4            "code": "InvalidInput",
5            "message": "Logged in user has no retailer"
6        }
7    ]
8}
Invalid User
1{
2    "errors": [
3        {
4            "code": "401",
5            "message": "Invalid user, Authorization header value does not belong to a valid user"
6        }
7    ]
8}
Invalid Authentication Object
1{
2    "error": "unauthorized",
3    "error_description": "An Authentication object was not found in the SecurityContext"
4}

Error Code: 403 Examples

Missing Permissions
1{
2    "errors": [
3        {
4            "code": "403",
5            "message": "User null does not have permission WORKFLOW_VIEW in context PermissionContext(type=RETAILER, id=1)"
6        }
7    ]
8}

Error Code: 406 Examples

Invalid Plugin
1Only Verified Bundles Can be Installed

Error Code: 500 Examples

Unsupported Operation
1{
2    "errors": [
3        {
4            "code": "500",
5            "message": "Request method 'GET' not supported"
6        }
7    ]
8}
Internal Server Error
1{
2    "errors": [
3        {
4            "code": "500",
5            "message": "An unknown error occurred"
6        }
7    ]
8}
Failed Request
1<html>
2 
3<head>
4    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
5    <title>Error 500 Request failed.</title>
6</head>
7 
8<body>
9    <h2>HTTP ERROR 500</h2>
10    <p>Problem accessing /rest/v1/plugin/bundleStatus. Reason:
11        <pre>    Request failed.</pre>
12    </p>
13    <hr><i><small>Powered by Jetty://</small></i>
14    <hr />
15 
16</body>
17 
18</html>

Error Code: 504 Examples

Gateway Timeout
1<html>
2 
3<head>
4    <title>504 Gateway Time-out</title>
5</head>
6 
7<body>
8    <center>
9        <h1>504 Gateway Time-out</h1>
10    </center>
11</body>
12 
13</html>
Holger Lierse

Holger Lierse

Contributors:
Kirill Gaiduk