API errors

401 (Unauthorized) Responses

Indicates that the provided authentication token is either missing, expired or invalid. This occurs when the API cannot verify the identity of the requesting user, typically due to an incorrect API key, expired JWT token or malformed authorization header.

403 (Forbidden) Responses

Indicates that while the user is authenticated, they lack sufficient permissions to access the requested company or organization resource. This occurs when the user's role or scope does not include authorization for the specific resource they are trying to access. The user would need to be granted appropriate permissions or added to the relevant company/organization to perform the requested action.

425 (Too Early) Responses

The API does not return data for measurement & optimization endpoints until a model has been fully tuned. To avoid returning data that may change during the training phase, a 425 - Too Early response will be returned from these APIs until model tuning is complete. If you believe that this data should be accessible for a specific company, speak to your Incremental representative.