Scenario |
HTTP Status Code |
API Call Successful, Access OK, Record Count 0 | 200 Metadata about the request is always returned, even if there is no data found, no records to return. |
API Call Successful, Access OK, Record Count 1+ | 200 Metadata plus one record or more are returned. |
API Call Missing Credentials / Unauthorized Check to see if your request contains a valid access_token or refresh_token. |
401 |
API Call Successful, Access Forbidden Permissions are missing, either in the OAuth 2 Scope, or the TrackTik web portal Employee (username and password) |
403 |
Validation Error / Bad RequestMany of our endpoints look for at least one filter to be provided to limit the impact on the back-end data services layer. /reports is one example, that requires at least a date range or position id. | 400 |
Internal Server ErrorTrackTik’s stuff is broken. | 500 |
With 403 Forbidden, you can check the Headers of the reponse for more information. If the Server value is “awselb/2.0“, the request is being rejected by the Firewall in front of the API and not the API itself.