Our API uses the following status codes:

The thethings.iO API attempts to return appropriate HTTP status codes for every request.

HTTP Status Code

Message

Description

200

OK

Success!

201

Created

Created / Pushed!

304

Not Modified

There was no new data to return

400

Bad Request

The request was invalid or cannot be otherwise served. An accompanying error message will explain further.

401

Unauthorized

Authentication credentials were missing or incorrect.

403

Forbidden

The request is understood, but it has been refused or access is not allowed. An accompanying error message will explain why. This code is used when requests are being denied due to rate limits.

404

Not found

The URI requested is invalid or the resource requested, such as a user, does not exists. Also returned when the requested format is not supported by the requested method.

410

Gone

This resource is gone. Used to indicate that an API endpoint has been turned off. For example: “thethings.iO REST API v1 will soon stop functioning. Please migrate to API v2.”

429

Too Many Requests

Returned in API v2 when a request cannot be served due to the application’s rate limit having been exhausted for the resource.

500

Internal Server Error

Something is broken. Please contact with support.

502

Bad Gateway

thethings.iO is down or being upgraded.

503

Service Unavailable

thethings.iO servers are up, but overloaded with requests. Try again later.

504

Gateway timeout

thethings.iO servers are up, but the request couldn’t be serviced due to some failure within our stack. Try again later.