Errors

ProcureIQ returns JSON error responses inside the standard response envelope.

Example error

{
  "success": false,
  "error": "Invalid API key"
}

Common status codes

Code	Meaning	Typical action
400	Invalid request payload or query	Fix request shape
401	Missing or invalid credentials	Refresh token or key
403	Missing scope or role	Expand scopes or permissions
404	Resource not found	Check IDs and ownership
409	Conflict with current state	Retry after state changes
429	Rate limit exceeded	Back off and retry later
500	Unexpected server fault	Retry with observability context

Troubleshooting flow

1. Capture the request ID if provided by your gateway.
2. Log the response status and body.
3. Verify auth scopes first.
4. Reproduce with curl or Postman before escalating.