Bolt uses standard HTTP status codes. Error responses include a JSON body with details when validation fails.

​
Common status codes

StatusAction
400Fix request parameters
401Check API key
403Verify HMAC signature or permissions
404Confirm resource ID and environment
422Review field-level validation errors
429Back off and retry with exponential delay
5xxRetry; contact support if persistent

​
Idempotency

Use idempotency keys on payment and order mutations where supported. See Idempotency reference.

​
Full error catalog

See Bolt error codes for the complete list.