Knowledge Base

Release Notes

Compliance & Security

Blog

Fax.Plus API

Create an account

Purchase an available fax number. (Permitted scopes: **fax:all:edit**, **fax:shop:edit**)

Purchase a number

oauth2

personal access token

Integrate online fax functionalities in your workflow

Introduction

Quickstart

Authentication

Outbox

Number

Webhook

Shop

Python

Javascript

Get account information of all non-admin members of your corporate account. Only the admin account can send a request to this endpoint which returns the accounts of all members (Permitted scopes: **fax:all:read**, **fax:member:read**)

List corporate members

Get information about an account. For members user_id can only be self. For admin it can be either self, or a user_id of any corporate member. (Permitted scopes: **fax:all:read**, **fax:member:read**, **fax:user:read**)

Get account information

Modify personal information of your own account or your corporate member's account. user_id can be either self, or a subordinate's user_id. (Permitted scopes: **fax:all:edit**, **fax:member:edit**, **fax:user:edit**)

Modify account information

Get corporate member's role and faxing quota (Permitted scopes: **fax:all:read**, **fax:member:read**)

Get member details

Update corporate member's role and faxing quota. (Permitted scopes: **fax:all:edit**, **fax:member:edit**)

Modify member details

List your purchased/assigned phone numbers. For corporate members all assigned numbers will be returned, while for the corporate admin, all purchased numbers. (Permitted scopes: **fax:all:read**, **fax:numbers:read**)

List phone numbers

Get information about a single purchased/assigned fax number (Permitted scopes: **fax:all:read**, **fax:numbers:read**)

Get number information

Assign fax number to a corporate member (Permitted scopes: **fax:all:edit**, **fax:numbers:edit**)

Assign number

Revoke fax number from a corporate member. To revoke your own number use self as a user_id. (Permitted scopes: **fax:all:edit**, **fax:numbers:edit**)

Revoke number

Get your own or your subordinate's faxes list. (Permitted scopes: **fax:all:read**, **fax:fax:read**)

List fax records

Get a specific fax record details like duration, pages etc. (Permitted scopes: **fax:all:read**, **fax:fax:read**)

Get a fax record

You can modify a fax record's comment or mark it as read. (Permitted scopes: **fax:all:edit**, **fax:fax:edit**)

Modify fax record

Delete a specific fax record by providing its id. (Permitted scopes: **fax:all:edit**, **fax:fax:edit**)

Delete a fax

Before sending a fax you need to upload your files using this API. In order to upload your fax file, you have to send a `multipart/form-data` request with your file. Set the `name` to `fax_file`, `filename` to your file's name with extension, and the Content-Type to the file's MIME type. In most cases, the `filename` directive will be automatically added by your library of choice. If the upload was successful you would receive a `file_path` which you can use to send your fax. (Permitted scopes: **fax:all:edit**, **fax:file:edit**)

Upload a file

Download sent or received fax file. (Permitted scopes: **fax:all:read**, **fax:file:read**)

Download fax file

Retrieve fax confirmation report (Permitted scopes: **fax:all:read**, **fax:fax:read**)

Get fax confirmation report

Retrieve fax thumbnail (Permitted scopes: **fax:all:read**, **fax:fax:read**)

Get fax thumbnail

Get a list of the faxes in the outbox which were not yet sent. (Permitted scopes: **fax:all:read**, **fax:fax:read**)

List faxes in the outbox

Send a fax to one or more destinations. For corporate members without a fax number assigned set the 'from' parameter to 'no_number'. (Permitted scopes: **fax:all:edit**, **fax:fax:edit**)

Send a fax

Get a list of faxes currently scheduled for sending. (Permitted scopes: **fax:all:read**, **fax:fax:read**)

List outgoing faxes

Modify an outgoing fax that is being scheduled for sending. (Permitted scopes: **fax:all:edit**, **fax:fax:edit**)

Modify an outgoing fax

Delete an outgoing fax that is being scheduled for sending. (Permitted scopes: **fax:all:edit**, **fax:fax:edit**)

Delete an outgoing fax

Returns a list of currently registered webhooks for the requested **event**. (Permitted scopes: **fax:all:read**, **fax:webhook:read**)

List user webhooks

Register a new webhook which will be called on a specific event. See the WebhookCallback model. (Permitted scopes: **fax:all:edit**, **fax:webhook:edit**)

Register new webhook

Delete a webhook by its ID. (Permitted scopes: **fax:all:edit**, **fax:webhook:edit**)

Delete webhook

Get your account balance. (Permitted scopes: **fax:all:read**, **fax:shop:read**)

Get account balance

Get a list of countries where you can purchase fax numbers. (Permitted scopes: **fax:all:read**, **fax:shop:read**)

List countries

Get a list of areas where you can purchase fax numbers for a specific country. (Permitted scopes: **fax:all:read**, **fax:shop:read**)

List areas

Get a list of available fax numbers for a specific area. (Permitted scopes: **fax:all:read**, **fax:shop:read**)

Get Started

Concepts

SDKs

API Reference

Purchase a number

Authorizations

Body

Response