Definition

Number Acquisition

Number Assignment

Number Ownership

Notifications

Key Concepts

Number Properties

Sending Faxes

Receiving Faxes

Managing Numbers

Schema

Using Numbers

Knowledge Base

Release Notes

Compliance & Security

Blog

Fax.Plus API

Create an account

Number

Integrate online fax functionalities in your workflow

Introduction

Quickstart

Authentication

Outbox

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**)

List available numbers

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

Property	Description
id	Unique identifier for the number
number	The actual phone number in E.164 format (e.g., +16699990000)
owner_id	ID of the user or organization that owns the number
status	Current status of the number (waiting_verification or active)
assigned_to	Array of user IDs to whom this number is assigned
acquired_date	Date and time when the number was acquired
expiration_date	Date when the number will expire (if applicable)
is_canceled	Boolean indicating if the number has been canceled
notifications	Array of notification settings for various events

Get Started

Concepts

SDKs

API Reference

Number

Definition

Key Concepts

Number Acquisition

Number Assignment

Number Ownership

Notifications

Number Properties

Using Numbers

Sending Faxes

Receiving Faxes

Managing Numbers

Schema

Get Started

Concepts

SDKs

API Reference

​Definition

​Key Concepts

​Number Acquisition

​Number Assignment

​Number Ownership

​Notifications

​Number Properties

​Using Numbers

​Sending Faxes

​Receiving Faxes

​Managing Numbers

​Schema

Definition

Key Concepts

Number Acquisition

Number Assignment

Number Ownership

Notifications

Number Properties

Using Numbers

Sending Faxes

Receiving Faxes

Managing Numbers

Schema