# status push

Sends a status push message

## Send a status push message to the URL of your choice

 - [POST /your/desired/path](https://developers.retarus.com/fax/status-push-api/status-push/paths/~1your~1desired~1path/post.md): Notification via HTTP implies the customer is operating an HTTP server that accepts the specified URL HTTP POST requests from Retarus' infrastructure. The customer should provide and configure:
* A target web service accepting HTTP POST requests
* An authentication method. The following are supported at the moment:
  * HTTP_BASIC
  * HTTP_DIGEST
  * OAUTH2
  * NONE

The parameters should be provided in each HTTP request made in Faxolution for Applications. 
By default, the format of the status push is the same as the response to a getFaxReports in the Faxolution for Applications SOAP API. If you prefer to use a custom format, please contact Retarus.

In the corresponding HTTP response from the customer’s server, a status code in the 200-299 range is expected if the HTTP request was successfully received. 
If there are errors, a status code in the 400-499 range (in cases of erroneous requests) or the 500-599 range (in cases of HTTP server errors) should be provided.