Error codes

What each Eebz API error code means and how to fix the request.

A failed request returns one of the codes below. A 401 response means the token is missing or invalid; see the API overview.

CodeDescription
hourly_api_limit_exceededThe hourly request limit is reached. Wait before retrying.
request_already_in_progressAn earlier request for your organisation is still running.
no_geographies_foundgeography_ids is missing or empty. Send at least one territory ID.
invalid_paramsThe request has parameters the API doesn't recognise.
non_org_or_invalid_geography_foundA territory ID in geography_ids is invalid or isn't one of your organisation's territories.
empty_retailer_importanceretailer_importance was sent as an empty array.
invalid_retailer_importanceretailer_importance has invalid values.
invalid_retailer_importance_formatretailer_importance was not an array.
retailer_importance_user_not_set_up_for_api_tokenNo retailer selection is set for importance filtering. Set one in API settings.
invalid_fieldsOne or more names in fields aren't recognised.
invalid_fields_formatfields was not an array of strings.

Last updated October 2026