Fans United APIs raise an exception for many reasons, such as bad parameters, wrong or expired token, network unavailability. Each exception contains a descriptive message about the error and a standard HTTP response code to indicate the result of an API request. Generally: Codes starting with 2xx indicate success. Codes starting with 4xx indicate cases in which the error seems to have been caused by the client. Codes in the 5xx range indicate that server failed to fulfill a request. The following example response bodies can be returned in case of an error:

400 - Bad Request

The request was unacceptable, often due to missing, wrong or empty parameter.

{
	"error": {
		"code": 400,
		"message": "No client found with the given id",
		"status": "no_client_found"
	}
}

401 - Unauthorized

No valid token or api key provided. This response could be returned without a body.

{
	"code": 16,
	"message": "Method doesn't allow unregistered callers (callers without established identity). Please use API Key or other form of API consumer identity to call this API.",
	"details": [
		{
			"@type": "type.googleapis.com/google.rpc.DebugInfo",
			"stackEntries": [],
			"detail": "service_control"
		}
	]
}

403 - Forbidden

Provided token doesn't have permissions to perform the request.

{
	"error": {
		"code": 403,
		"message": "User does not have permissions to set global roles",
		"status": "no_permissions_to_set_global_roles"
	}
}

404 - Not Found

The requested resource doesn't exist.

{
	"error": {
		"code": 404,
		"message": "No clients found for this user",
		"status": "no_clients_found_for_user"
	}
}

500 - Internal Server Error

Indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.

{
	"error": {
		"code": 500,
		"message": "Failed to delete user",
		"status": "failed_to_delete_user"
	}
}

A list of error statuses

This is a list of all statuses available per API.

Common

unknown_error
id_doesnt_exists
forbidden
internal_server_error
invalid_page
unauthorized
validation_error
invalid_sort_order
invalid_gender
invalid_url
service_invocation_error
client_id_required
invalid_client_id
predictor_feature_disabled

Football API

missing_competition_ids
invalid_competition_type
missing_team_ids
missing_player_ids
invalid_date_range
invalid_language
bad_date_format
next_match_not_found
previous_match_not_found
invalid_status
invalid_sort_field
invalid_date_range

ID Mapping API

invalid_resource_name
id_required
record_id_exists
existing_id_mismatch
invalid_resource_id
ids_limit_reached
invalid_id
invalid_id_provider

Profile API

invalid_ids
user_not_exists
api_key_not_linked
empty_profile_ids
invalid_name
invalid_avatar
invalid_country_name
client_exists
profile_already_exist
invalid_interests
country_not_exists
type_not_exists
invalid_profile_id
nickname_already_taken
profile_not_found_or_deleted
error_deleting_profile

Prediction API

invalid_prediction_data
invalid_game_data
game_not_found
predicton_not_found
invalid_game_status
predictions_cutoff
predictions_schedule_time
game_instance_id
invalid_game_instance_id
invalid_match_id
cannot_update_open_game
match_not_found
query_not_allowed
max_match_ids_allowed
game_not_finished
predictions_are_being_processed_now

Loyalty API

invalid_date
invalid_timespan
invalid_match_ids
template_not_found
activity_not_found
tiers_not_found
invalid_competitions_id
invalid_teams_ids
invalid_players_id
invalid_games_id
loyalty_disabled
invalid_action
invalid_json
invalid_user_id
invalid_content
invalid_campaign
invalid_market
invalid_type
invalid_success_rates
invalid_points
invalid_overall_percent
invalid_competition_percents
invalid_market_percents
invalid_team_percents
statistics_error
invalid_related_template_ids

Reporting API

invalid_group_by
invalid_date
competition_not_found
missing_entity_id