Errors

The API returns standard HTTP status codes. Error responses include a JSON body with error details and a suggested fix.

Status	Meaning
400	Bad request — check the request body and file formats
401	Authentication error — missing or invalid API key
402	Insufficient credits — top up your account to continue
429	Rate limit exceeded
500	Server error

Example error response

HTTP/1.1 400 Bad Request
Content-Type: application/json

{
  "error": {
    "code": "invalid_file_format",
    "message": "File 'scan.tiff' is not a supported format.",
    "suggestion": "Upload JPEG, PNG, HEIC images or MP4/MOV video."
  }
}

Insufficient credits

Each reconstruction consumes 1 credit. If your account balance is 0, POST /v1/reconstruction returns:

HTTP/1.1 402 Payment Required
Content-Type: application/json

{
  "error": {
    "code": "insufficient_credits",
    "message": "Your account has insufficient credits to complete this request.",
    "suggestion": "Top up your credit balance in the dashboard, then retry the request."
  }
}