PDF Splitter endpoint [new]

In - pdf with multiple invoices\receipts

Out - a list of separate documents

New endpoint:

POST https://:.veryfi.com/api/v8/partner/documents-set-async

Response body


"id": " "


What is expected:

Veryfi will split the original PDF and process them separately.

When processed, a notification will be sent to client’s webhook similar to async processing.


If in your use case you don't use async and don't need a webhook notification you can still use https://devapi.veryfi.com/api/v8/partner/documents-set-async without adding "async": ture / false and having a webhook setup.

Sample of a webhook notification:


"event": "document.created",

"data": {"id": [1031, 1032, 1033],

"created": "2022-06-01 20:00:00"


"id" will contain a list of separate child documents created from the original parent, which can be queried with GET documents:

GET https://devapi.veryfi.com/api/v8/partner/documents/1031

GET https://devapi.veryfi.com/api/v8/partner/documents/1032

Known limitations:

Splitting is based on:
-Page numbers (present on all pages)

-Invoice number (if the invoice number is different -> new document)

-File size 20 Mb max

-Page number 100 max

-Endpoint uses the v8 model, if you use v7 you can still process using v8 and by running a GET request call v7

GET https://devapi.veryfi.com/api/v7/partner/documents/1032

- JSON fields for document "is_child" of "parent_of" not yet displayed, so a webhook notification is the only source to see the child documents.

Additional Resources:

-Webhooks/async: https://faq.veryfi.com/en/articles/5588143-webhooks-and-asynchronous-processing

-v7 vs v8: https://faq.veryfi.com/en/articles/6120104-api-version-7-vs-8

This is a very beginning of splitting functionality, we appreciate your feedback submitted to support@veryfi.com with the "id" and stating what worked and what didn't. Your feedback helps us improve.

Did this answer your question?