News & Announcements User Community Developer Community

Welcome to the RingCentral Community

Please note the community is currently under maintenance and is read-only.

Make sure to review our Terms of Use and Community Guidelines.
  Please note the community is currently under maintenance and is read-only.
Home » Developers
Fax status, how to interpret and how to be sure it is the final one?
Tags: rest api
Nov 8, 2019 at 12:04pm   •   3 replies  •  0 likes
Nick R


I have to send faxes through RingCentral for two of the company I work for legacy applications.

For one of them, I have to report back to the applicatiom, using a pretty weird mechanism, if the faxes were sent properly.

Those applications only send faxes to one recipient at a time so it looks like my best bet to get the most precise fax status and error message would be to look at "messageStatus" and "faxErrorCode" under "to".h

I am not sure how to interpret those statuses though and if any of them, besides "Queued" are temporary statuses or final ones...

According to the doc "messageStatus" can take the following values:

Queued, Sent, Delivered, DeliveryFailed, SendingFailed, Received

Now Queued is obviously a temporary status but what about the others. Can the same fax go from DeliveryFailed to Delivered after RingCentral retries to send the faxes.

What about Sent, does it mean the same thing as Delivered or Received?

The doc only seems to mention Queued, SendingFailed and Sent, are the others legacy return codes?

By the way, there seems to be no way to change the number of retries one wants to send a fax, I assume this is setted up by our telephony guy?

Thank you and have a nice day,


3 Answers
answered on Nov 14, 2019 at 10:00am  

Basically, for outbound fax status, you will receive just the following status:

Queue: your fax is in a queue waiting for to be sending

Sent: You fax has been sent

SendingFailed: Your fax sending failed.

answered on Nov 11, 2019 at 8:40am  


I had already read some of the pages you referred me to and unfortunately they (and the new ones you referred me to), do not actually answer my questions. Thank you for your help however...

I must provide to my users the same functionality they had before so asking them to look at a web page on this site to get their fax status and asking them to manually update the fax statuses in our legacy applications is unfortunately out of the question.

By default, how many times does RingCentral try to send a fax before giving up? I doubt it only tries one time and I have to programmatically or manually try to ask for a retry...

Maybe one of the pages you referred me to initially had the answer but one of the links you provided me with ( first link gives me a 404.


Like I said before the 6 statuses are documented but only explanations are only given for like 3 of them, are the others legacy stuff?

Thank you and have a nice day,


answered on Nov 8, 2019 at 12:43pm  

As per this :

“Sent” means that message was sent successfully

In general Fax can be viewed in the Service Web Portal ( in both Messages > Sent Items and in the Call Log.

If a fax transmission fails, the reason is reported in the Call Log Record's result property. It is also presented in the Service Web Portal. All the Fax question are answered here and the following link will be helpful:


As per this link

To resend a fax, call the fax endpoint with the originalMessageId property

You can also use this API for resending and retrying fax and changing the number of retries :



A new Community is coming to RingCentral!

Posts are currently read-only as we transition into our new platform.

We thank you for your patience
during this downtime.

Try Workflow Builder

Did you know you can easily automate tasks like responding to SMS, team messages, and more? Plus it's included with RingCentral Video and RingEX plans!

Try RingCentral Workflow Builder

Developer Platform
Integrated Apps
App Gallery
Developer support
Games and rewards

Resource center
Product Releases
App Download
RingCentral App login
Admin Portal Login
Contact Sales
© 1999-2024 RingCentral, Inc. All rights reserved. Legal Privacy Notice Site Map Contact Us