This defines the Upload File API:
A Fax API request looks like:
https://fax.to/api/v2/files?api_key=xxxxx
This request contains:
The following table shows the parameters you use in the request:
Parameter | Description | Required |
---|---|---|
file | The Local File to upload | Yes |
The following table shows the information for authentication:
Parameter | Description | Required |
---|---|---|
api_key | Your Key. For example, api_key=f@x2r0ckkz . |
Yes. |
You find your Key in Dashboard.
To ensure privacy, you must use HTTPS for all Faxto API requests.
You submit all requests with a POST or GET call using UTF-8 encoding and URL encoded values. The expected Content-Type
is multipart/form-data
.
We support JSON ONLY responses
{
"status": "Success",
"document_id": 300,
"total_pages": 1,
"document": {
"filename": "598317a8404bd.pdf.tiff",
"filename_uploaded": "verify.txt",
"orig_filename": "598317a8404bd.pdf",
"file_extension": "txt",
"total_pages": 1,
"filesize": 3650,
"preview_in_storage": 1,
"preview_file": "598317a8404bd.pdf.preview.jpg",
"preview_image": null,
"s3": null,
"user_id": 2,
"updated_at": "2017-08-03 12:31:38",
"created_at": "2017-08-03 12:31:38",
"id": 300
}
}
Key | Value | Response Type |
---|---|---|
status | The status of the API request | JSON |
document_id | The document ID stored. Use this document_id when sending Fax using API | JSON |
total_pages | The number of pages stored | JSON |
document | Array containing document details | JSON |
HTTP Status Code | Reason |
---|---|
200 | Successful response |
401 | Unauthorized. |
403 | Rate limit exceeded |
404 | Resource not Found |
500 | Internal server error |