What file formats does Veryfi support?
Supported formats vary by API endpoint, but all endpoints share the same file size limits: min 0.25 KB, max 20 MB.
Always check the API docs for the most up-to-date information
This article reflects the formats documented at the time of writing. Supported file types can change as new formats are added or updated. For the latest and most accurate list, always refer to the official API reference: Veryfi API Docs
Receipts & Invoices
Endpoint: POST /api/v8/partner/documents Rate limit: 60 requests/second
.jpg .jpeg .png .gif .webp .avif .bmp .heic .heif .pdf .zip .txt .html .htm .eml .ofd .rtf .odt .doc .docx .xls .xlsx .csv
Note: Not all formats are enabled by default. Contact support to request access to additional types (e.g. .txt). This is the only endpoint with per-client format restrictions.
The maximum number of pages that can be processed at once is 15. Contact support to increase this limit. learn more about Max pages to process paramter.
Checks
Endpoint: POST /api/v8/partner/checks Rate limit: 20 requests/second
.jpg .jpeg .png .webp .heic .heif .pdf .zip
W-9
Endpoint: POST /api/v8/partner/w9s Rate limit: 20 requests/second
.jpg .jpeg .png .webp .heic .heif .pdf .zip
AnyDocs
Endpoint: POST /api/v8/partner/any-documents Rate limit: 60 requests/second
.jpg .jpeg .png .webp .bmp .gif .heic .heif .pdf .ofd .zip .txt .html .htm .rtf .odt .doc .docx .xls .xlsx .csv
Classification
Endpoint: POST /api/v8/partner/classify Rate limit: 60 requests/second
.jpg .jpeg .png .gif .webp .avif .bmp .heic .heif .pdf .zip .txt .html .htm .eml .ofd .rtf .odt .doc .docx .xls .xlsx .csv
W-2
Endpoint: POST /api/v8/partner/w2s Rate limit: 60 requests/second
.jpg .jpeg .png .webp .heic .heif .pdf .zip
Max 2 pages per document.
Tips for all endpoints
.zipfiles let you bundle multiple images or files for a single document. Files are processed in alphabetical order by filename. Submitting a zipped file via thefilebinary parameter is the fastest upload method.file_url/file_urlsaccept publicly accessible URLs and are the recommended method for most use cases.file_dataaccepts a base64-encoded string but is the least performant option.S3 uploads are supported via the
package_pathandbucketparameters.
Error messages
Message | Meaning |
| The format exists but is not activated for your account. Contact support to enable it. |
| The format is not accepted by this endpoint. |
| File exceeds the 20 MB limit. |
What file type to expect after a document is processed on Veryfi side:
The general rule is that .pdf is returned unless the submitted file is a .png, .jpg, .heif image (zipped or not)
img_thumbnail_url - is always a .jpg a small preview of that document (thumbnail)
img_url - is a little more complicated:
for .pdf.txt, .gif, .htm, .html, .ojd - the resulting extension will be .pdf
for .heic, .heif, .avif, .jpg, .jpe, .jpeg, .png, .gif, .webp, - the resulting extension will be .jpg
pdf_url field response is always consistent, it will always have a document with .pdf extension regardless of the input format.
.jpg - is the expected resulting extension for all requests submitted via Veryfi Lens.
Web uploader (Veryfi Hub)
The web uploader at app.veryfi.com accepts fewer formats than the API due to frontend limitations:.jpg .jpeg .png .pdf .heic .heif
For any other format, use the API directly or use Veryfi Interactive API inside API Docs
โ
Email Collector (Veryfi Hub)
#2 Email collector supports:
HTML
Plain Text
PDF
Image Attachment
How does Veryfi work with Zip files?
.zip is a special case, itโs a package for all file types we support.
.zip can be used when users have multiple separate images or files for the same Document.
For .zip There are 2 cases:
when there is one document in the
.zipthen refer to the above logicwhen there is more than one document - then Veryfi will stitch those documents and the resulting format for
img_urlfield will be.pdfWhen you submit.zip, the system combines those separate images or files into one.pdfand processes it as 1 Document.
Please note, .zip file can be submitted via direct API call only. Files are ordered by the file name in alphabetical order.
Code sample for processing .zip inside your Veryfi portal API documentation: https://docs.veryfi.com/api/getting-started/document-processing
