Skip to main content

Split and process multiple Bank Statements

POST 
/api/v8/partner/bank-statements-set

Veryfi's Bank Statement Splitter allows you to split a multi page PDF with different Bank Statements inside into multiple Documents. This API supports .zip,.pdf. The max pdf file size is 50mb. The max number of pages to process is limited to 100. Returns the response with the document set id immediately and starts processing asynchronously. When processing is finished successfully, you should expect a request to your configured webhook with this payload:

{'event': 'bank_statement_set.created', 'data': {'parent_id': 42000, 'id': [690001, 690003, 690004], 'created': '2025-08-23 04:06:10'}}

If processing fails, the payload will be: {'event': 'bank_statement_set.failed', 'data': {'parent_id': 42000, 'id': [], 'created': '2025-08-23 04:06:10'}}

Request​

Body

    external_id (string | null)deprecated

    Possible values: non-empty

    Deprecated. Please use meta.external_id instead.

    meta.external_id (string | null)

    Possible values: non-empty

    External ID you want to associate with the document.

    meta.tags string[]

    Possible values: non-empty

    Default value: ``

    Tags you want to associate with the document.

    package_path (string | null)

    Possible values: non-empty

    A path to a file in an S3 bucket, e.g. 'some/receipt.jpg

    bucket (string | null)

    Possible values: non-empty

    An S3 bucket for 'package_path', e.g. 'documents'.

    file_data (string | null)

    Possible values: non-empty

    Used to upload a document via base64 encoded string, could be raw or data URI scheme. This is the least effective way to upload a document for processing. See file_urls or uploading zip files.

    file_url (string | null)

    Possible values: non-empty

    A URL to a publicly accessible document to be sent to Veryfi for processing.

    file_urls string[]

    Possible values: non-empty

    An array of URLs to publicly accessible documents to be sent to Veryfi for processing.

    file_name (string | null)

    Possible values: non-empty

    An optional filename. Useful to determine file type.

    max_pages_to_process (integer | null)

    Possible values: >= 1 and <= 50

    Default value: 50

    Limit processing to number of pages.

Responses​

The unique identifier of a document set.

Schema
    id integerrequired

    The unique identifier of the collections of processed documents.

    document_ids integer[]

    The unique identifiers of the documents created from processed PDF Splitter.

    status stringrequired

    Possible values: [processed, in_progress, deleted, failed]

    page_breaks object[]

    A list of page breaks to split a document. Each object defines what pages to use to create a new document.

  • Array [
    • page_start integerrequired

    Possible values: > 0

    Page start

    page_end integerrequired

    Possible values: > 0

  • ]
Loading...