Skip to main content
The Sohar API follows REST principles. Our API endpoints return JSON-encoded responses, using standard HTTP response codes, authentication and verbs. All requests must be made over HTTPS. Requests can be made in our production or sandbox environment. The sandbox environment exists to support your integration and testing of the Sohar API, and doesn’t affect live data. The environment is determined by the API key used to authenticate the request. It’s important to note that while any changes to existing API endpoints and webhook fields that could impact your integration will be communicated in advance, new fields may also be introduced. To ensure seamless integration, it is recommended that your system be designed with flexibility in mind, accommodating potential additions without requiring modification.

​
Response Codes

We use standard HTTP response codes to indicate the status of an API request. Our response codes include the following:
CodeDescription
200The request succeeded.
201The request succeeded, and a new resource was created as a result.
207Conveys information about multiple resources, for situations where multiple status codes might be appropriate.
400The server cannot or will not process the request due to something that is perceived to be a client error.
403The client does not have access rights to the content.
404The server cannot find the requested resource.
500The server has encountered a situation it does not know how to handle.