Welcome to the RingCentral Community

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

How to know if a fax transmission through the API succeeded?

Tags: fax, rest api

Jun 18, 2015 at 12:49pm • 2 replies • 0 likes

If you want to learn how to check the status of a fax transmission via the API here is the answer:

When you are sending a fax message through the FaxOut API, you can check the status of its transmission. Outgoing faxes pass through several workflow phases, so when you have just sent an API request message its status will be Queued (this status is returned in the FaxOut API response).

After some time (usually within couple of minutes) the status of the fax message will be changed to either Sent (which means that the fax was sent successfully) or to Sending Failed.

You can call the Get Message or the Get Message List API to check the status of a particular message.

Read more here

2 Answers

Anirban answered on Jun 29, 2019 at 11:16am

In general Fax can be viewed in the Service Web Portal (https://service.ringcentral.com) 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:

ref: https://forums.developers.ringcentral.com/questions/144/fax-faq.html

jason-wright answered on Sep 4, 2015 at 7:44am

Is there any way to see WHY a fax failed? It would be nice to know if it was because the line was busy or there was no answer or if there was another problem. I know I can look at the Call Log but I can't see how to match it up with the faxes. For instance, yesterday we sent 3 faxes to the same number in a short period of time. 1 of them failed. Looking at the call log for that number I can see that 7 total attempts were made for those 3 faxes but I can't tell which call log records belong to which fax. If we could filter the call log by Fax ID of have the Call Log return the Fax ID then that would help a ton.

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

PRODUCTS
RingEX
Message
Video
Phone

OPEN ECOSYSTEM
Developer Platform
APIs
Integrated Apps
App Gallery
Developer support
Games and rewards

RESOURCES
Resource center
Blog
Product Releases
Accessibility

QUICK LINKS
App Download
RingCentral App login
Admin Portal Login
Contact Sales