Response to web API requests: 400: Bad request

parse_error

The response means that either your request is not a valid JSON or some field is missing. Correct the JSON to make it valid and add the missing parameter.

Body

Parameter	Type	Description
errors	Object	source: (string) For invalid JSON, it will be null. errors: A description of the error.
error_code	String	Short error name. Here: parse_error.
status_code	Integer	HTTP status. Always 400.

Response example

{
    "errors": [
        {
            "source": null,
            "errors": [
                "JSON parse error - Expecting ',' delimiter: line 4 column 3 (char 67)"
            ]
        }
    ],
    "error_code": "parse_error",
    "status_code": 400
}

datetime

The request failed because the format of the visited_at field is incorrect. Use the ISO 8601 date format, e.g. 2025-01-14T14:15:22Z.

Body

Parameter	Type	Description
errors	Object	source: (string) Always visited_at. errors: A description of the error.
error_code	String	Short error name. Here: base_error.
status_code	Integer	HTTP status. Always 400.

Response example

{
    "errors": [
        {
            "source": "visited_at",
            "errors": [
                "invalid datetime format"
            ]
        }
    ],
    "error_code": "datetime",
    "status_code": 400
}

enum

The request failed because the value of the status field is invalid. Please check for typos. The possible values are organic, non_organic, and unknown.

Body

Parameter	Type	Description
errors	Object	source: (string) Always status. errors: A description of the error. In this case, value is not a valid enumeration member; permitted: 'organic', 'non_organic', 'unknown'
error_code	String	Short error name. Here: enum.
status_code	Integer	HTTP status. Always 400.

Response example

{
    "errors": [
        {
            "source": "status",
            "errors": [
                "value is not a valid enumeration member; permitted: 'organic', 'non_organic', 'unknown'"
            ]
        }
    ],
    "error_code": "enum",
    "status_code": 400
}