Errors

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

Common status codes

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

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

See Bolt error codes for the complete list.