HTTP Response Codes

We use HTTP Response Codes to communicate a certain status to your system when interacting with our API. Below is a table with a list of codes and what they mean in context. Generally speaking, we aim to align with the general guidance provided in the underlying HTTP standard.

Response Code	Description	Notes
200	Ok	Most all of the endpoint are a POST action. A response code of 200 indicates that the POST was successful and did not encounter an error,
401	Unauthorized	If the request already included Authorization credentials, then the 401 response indicates that authorization has been refused for those credentials. Review Authentication and make sure you have the correct authentication.
403	Forbidden	The server understood the request, the token provided is validated but the device is not authorized to access that endpoint.
404	Not Found	A 404 indicates that the URL for the request was invalid. Check your code to make sure you are using a published endpoint.
500	Internal Server Error	Something went wrong when fulfilling the request on the server side. Contact support for additional information and troubleshooting.

All errors return a body with the following JSON schema:

{
    "timestamp": "03-01-2022 14:33:58",
    "status": 500,
    "error": "Internal Server Error",
    "message": "<error message>"
}

In addition all HTTP responses will contain a transaction id if a transaction was initiated, which can be used for tracking down the error in our logging system.

OneRecord-Transaction-ID: e683d690-cd04-4438-b94e-2692a5f61631