Troubleshooting
Understanding print job errors
Every API error follows the same format — a message, a type, and a code. Here's what the common ones mean and how to get further help.
Last reviewed · By Intelliprint Team
When something goes wrong, the Intelliprint API always returns the same standardised error shape: a human-readable message, a general type, a specific code, and — where relevant — which parameter caused it. The official SDKs parse these automatically into native error objects.
Common causes
- A parameter was missing, invalid, or misspelled — the error will name the parameter.
- Your API key is missing, invalid, or has expired.
- Your account balance can't cover the cost of the job, or you've reached your credit limit.
- You've sent requests faster than the rate limit allows.
- Something went wrong on Intelliprint's side — these are rare and logged automatically on our end.
- The request never reached the API — this is only raised by the SDKs themselves, when they can't connect.
Getting help
Check the API reference for endpoint-specific parameter details.
Check the developer docs for setup guides covering common workflows.
If you're still stuck, email hello@intelliprint.net with the full error message and code, the request that caused it, and the print job ID if one exists — that's enough for our team to dig in straight away.