Errors

Troubleshoot problems with this comprehensive breakdown of all error codes and how to resolve them.

Error Schema

The Indieop API uses standard HTTP response codes to indicate the success or failure of requests. All error responses follow a consistent JSON format to help you quickly identify and resolve issues.

{
  "success": false,
  "message": "Brief description of the error",
  "errors": {
    "field_name": [
      "Detailed error message"
    ]
  }
}

HTTP Status Codes

The API returns the following HTTP status codes:

Error Types

Below is a comprehensive list of all possible errors you may encounter when using the Indieop API.

missing_api_key

• Status: 401
• Message: Missing X-API-Key header
• Suggested action: Include your game's API key in the request header: X-API-Key: YOUR_API_KEY

invalid_api_key

• Status: 401
• Message: Invalid or inactive API key
• Suggested action: Verify your API key is correct in the dashboard. If the game has been deactivated, you'll need to reactivate it or generate a new API key.

game_not_found

• Status: 404
• Message: Game not found or inactive
• Suggested action: Verify the game exists and is active in your studio dashboard. Inactive games cannot receive submissions.

resource_not_found

• Status: 404
• Message: The requested resource was not found
• Suggested action: Check that your request URL is correct and that the resource ID exists.

method_not_allowed

• Status: 405
• Message: HTTP method not allowed for this endpoint
• Suggested action: Check the API documentation to ensure you're using the correct HTTP method (GET, POST, etc.) for the endpoint.

validation_error

• Status: 422
• Message: We found an error with one or more fields in the request
• Suggested action: Review the errors object in the response for specific field validation failures. Common issues include:
  • Missing required fields (form_name, tag, fields)
  • Invalid field types (e.g., checkbox value must be boolean)
  • Dropdown value not in available options
  • Rating value not between 1-5
  • Exceeding maximum field count (10 fields per form)
  • Non-unique field keys within the same form

subscription_limit_exceeded

• Status: 403
• Message: Studio has reached its plan's limit for submissions
• Suggested action: Your studio has reached the monthly submission limit for your current plan. Upgrade your plan to increase the limit or wait until the next billing cycle.

rate_limit_exceeded

• Status: 429
• Message: Too many requests. Limit is 100 requests per minute
• Suggested action: You've exceeded the rate limit of 100 requests per minute. Implement request throttling in your application or reduce the frequency of API calls. The response includes rate limit headers that indicate when you can retry.

studio_configuration_error

• Status: 500
• Message: Game studio configuration error
• Suggested action: This indicates an internal configuration issue with your studio. Contact support at support@indieop.com for assistance.

internal_server_error

• Status: 500
• Message: An unexpected error occurred
• Suggested action: Try your request again. If the error persists, check our status page or contact support at support@indieop.com.