Handling Errors

Particle Health APIs support standard HTTP response status codes to indicate why something might not be working. Where possible, additional context will be included in the response to help you debug your implementation.

Code

Text

Context

400

Bad Request

Your request is invalid. Look at the error message to learn why.

401

Unauthorized

You used incorrect authentication credentials.

403

Forbidden

You have insufficient permissions to access the requested resource.

404

Not Found

The specified resource could not be found.

405

Method Not Allowed

You used an invalid HTTP method.

406

Not Acceptable

You requested a format that we don't support.

410

Gone

The resource requested has expired and been removed from our servers.

412

Precondition Failed

An operation might still be in progress.

429

Too Many Requests

You've made too many requests in a short period of time. Contact support if you feel this is in error.

500

Internal Server Error

Something went wrong on our end. Try again in a bit. We'll also be alerted automatically to look into it.

503

Service Unavailable

We're temporarily offline for maintenance. Try again in a bit.