> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.fax.plus/llms.txt
> Use this file to discover all available pages before exploring further.
# Number
## Definition
A **Number** in the Fax.Plus system represents a fax-enabled phone number. It can be used to send faxes from (as your own number) or to send faxes to (as a recipient's number). Numbers are a crucial part of the faxing process, allowing you to manage your fax communication channels effectively.
## Key Concepts
### Number Acquisition
* Numbers are acquired through the Fax.Plus service.
* Each number has an `acquired_date` indicating when it was obtained.
### Number Assignment
* Numbers can be assigned to one or more users within your organization.
* The `assigned_to` field contains an array of user IDs who have access to the number.
### Number Ownership
* Each number has an `owner_id`, typically the user or organization that acquired the number.
### Notifications
* Numbers can be configured with various notification settings for different events (e.g., receiving a fax, voicemail, etc.).
## Number Properties
| 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 |
## Using Numbers
### Sending Faxes
When sending a fax, you can specify the "from" number to use. This should be one of your acquired and active numbers.
### Receiving Faxes
Incoming faxes will be directed to the numbers you've acquired. You can set up notifications to alert you when a fax is received.
### Managing Numbers
The Fax.Plus API provides endpoints to:
* List all your numbers
* Get details about a specific number
* Assign numbers to users
* Revoke numbers from users
### Schema