---
title: "Error codes"
description: "What each Eebz API error code means and how to fix the request."
canonical_url: "https://www.eebz.com/support/api/error-codes"
---

A failed request returns one of the codes below. A `401` response means the token is missing or invalid; see the [API overview](/support/api).

<table>
<thead>
  <tr>
    <th>
      Code
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        hourly_api_limit_exceeded
      </code>
    </td>
    
    <td>
      The hourly request limit is reached. Wait before retrying.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        request_already_in_progress
      </code>
    </td>
    
    <td>
      An earlier request for your organisation is still running.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        no_geographies_found
      </code>
    </td>
    
    <td>
      <code>
        geography_ids
      </code>
      
       is missing or empty. Send at least one territory ID.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        invalid_params
      </code>
    </td>
    
    <td>
      The request has parameters the API doesn't recognise.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        non_org_or_invalid_geography_found
      </code>
    </td>
    
    <td>
      A territory ID in <code>
        geography_ids
      </code>
      
       is invalid or isn't one of your organisation's territories.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        empty_retailer_importance
      </code>
    </td>
    
    <td>
      <code>
        retailer_importance
      </code>
      
       was sent as an empty array.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        invalid_retailer_importance
      </code>
    </td>
    
    <td>
      <code>
        retailer_importance
      </code>
      
       has invalid values.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        invalid_retailer_importance_format
      </code>
    </td>
    
    <td>
      <code>
        retailer_importance
      </code>
      
       was not an array.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        retailer_importance_user_not_set_up_for_api_token
      </code>
    </td>
    
    <td>
      No retailer selection is set for importance filtering. Set one in API settings.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        invalid_fields
      </code>
    </td>
    
    <td>
      One or more names in <code>
        fields
      </code>
      
       aren't recognised.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        invalid_fields_format
      </code>
    </td>
    
    <td>
      <code>
        fields
      </code>
      
       was not an array of strings.
    </td>
  </tr>
</tbody>
</table>

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.