Skip to main content

Process a Bank Statement

POST 

/api/v8/partner/bank-statements

Veryfi's Process a Bank Statement endpoint allows you to submit and extract data from unstructured documents such as Bank Statements and turn them into valuable business insights. The Process a Bank Statement endpoint enables you to submit the following image formats: .zip,.pdf,.png,.jpeg,.jpg and retrieve extracted data in JSON format. The max file size is 20mb, min file size is 0.25kb. Rate limit is 20 requests per second.

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.

    bounding_boxes (boolean | null)

    A field used to determine whether or not to return bounding_box and bounding_region for extracted fields in the Document response.

    confidence_details (boolean | null)

    A field used to determine whether or not to return the score and ocr_score fields in the Document response.

Responses

Returns a processed Bank Statement.

Schema
    anyOf
    external_id (string | null)

    Possible values: non-empty

    A custom identification value. Use this if you would like to assign your own ID to documents. This parameter is useful when mapping this document to a service or resource outside Veryfi.

    meta object
    duplicates object[]

    An array of duplicate documents found in the system.

  • Array [
  • id integerrequired

    The id of the duplicate document.

    url urirequired

    Possible values: non-empty and <= 2083 characters

    The url of the duplicate document.

  • ]
  • external_id (string | null)

    Possible values: non-empty

    A custom identification value. Use this if you would like to assign your own ID to documents. This parameter is useful when mapping this document to a service or resource outside Veryfi.

    pages object[]
  • Array [
  • ocr_score (number | null)

    Possible values: <= 1

    The average OCR score of the page.

    width (integer | null)

    The width of the page.

    height (integer | null)

    The height of the page.

  • ]
  • tags string[]

    Possible values: non-empty

    Default value: ``

    Tags associated with the document.

    ocr_score (number | null)

    Possible values: <= 1

    The average OCR score of the whole document.

    model (string | null)

    Possible values: non-empty

    The version of the model used to process the document.

    fraud BankStatementsFraud

    An object that contains additional information to identify fraud.

    score (number | null)

    Possible values: <= 1

    Confidence of Fraud Detector in it's prediction

    color (string | null)

    Possible values: [green, yellow, red]

    Color from Fraud Detector: green means legitimate, yellow means review needed and red means fraud

    types string[]

    Possible values: [LCD photo, not a document, duplicate, screenshot]

    List of attributions which marked the document as fraud

    pdf_url uri

    Possible values: non-empty and <= 2083 characters

    A signed URL to access the auto-generated PDF created from the submitted document. This URL expires 15 minutes after the response object is returned and is resigned during every GET request.

    id integerrequired

    The unique number created to identify the document.

    created_date date-timerequired
    updated_date date-timerequired
    img_thumbnail_url uri

    Possible values: non-empty and <= 2083 characters

    A signed URL to access the auto-generated thumbnail created for the submitted document. This URL expires 15 minutes after the response object is returned and is resigned during every GET request.

    accounts object[]required
  • Array [
  • summaries object[]required

    Summary information

  • Array [
  • name (string | null)

    Possible values: non-empty

    The title or label that captures the main information

    total (number | null)

    The overall amount calculated from all transactions

  • ]
  • transactions object[]required

    A list of transactions associated with the account.

  • Array [
  • order integerrequired

    The value indicating the position of where the transaction appears on the bank statement.

    balance (number | null)

    The balance after any credit or debits have been applied from this transaction.

    card_number (string | null)

    Possible values: non-empty

    A credit card number associated with this transaction.

    credit_amount (number | null)

    The amount credited from this transaction.

    date date

    The date of the transaction in ISO 8601 format.

    posted_date date

    The date the transaction was posted in ISO 8601 format.

    debit_amount (number | null)

    The amount debited from this transaction.

    description (string | null)

    Possible values: non-empty

    The description of the transaction.

    category (string | null)

    Possible values: non-empty

    The category of the transaction.

    vendor (string | null)

    Possible values: non-empty

    The vendor of the transaction.

    transaction_id (string | null)

    Possible values: non-empty

    The unique identifier of the transaction.

    text (string | null)

    Possible values: non-empty

    The OCR text extracted from the transaction.

  • ]
  • number (string | null)required

    Possible values: non-empty

    The account number associated with the bank statement.

    beginning_balance (number | null)required

    The balance at the beginning of the statement period.

    ending_balance (number | null)required

    The balance at the end of the statement period.

    iban_number (string | null)

    Possible values: non-empty

    The International Bank Account Number

  • ]
  • account_holder_address (string | null)required

    Possible values: non-empty

    The address of the account holder.

    account_holder_name (string | null)required

    Possible values: non-empty

    The name of the account holder.

    account_number (string | null)required

    Possible values: non-empty

    The account number associated with the bank statement.

    account_type (string | null)required

    Possible values: non-empty

    The type of account associated with the bank statement.

    account_vat_number (string | null)required

    Possible values: non-empty

    The unique identifier for businesses used for tax purposes

    bank_address (string | null)required

    Possible values: non-empty

    The address of the bank.

    bank_name (string | null)required

    Possible values: non-empty

    The name of the bank.

    bank_vat_number (string | null)required

    Possible values: non-empty

    The unique identifier assigned to a bank for tax purposes

    bank_website (string | null)required

    Possible values: non-empty

    The URL for the website of the bank.

    beginning_balance (number | null)required

    The balance at the beginning of the statement period.

    currency_code (string | null)required

    Possible values: non-empty

    The currency code associated with the bank statement.

    due_date daterequired

    The date the payment is due in ISO 8601 format.

    ending_balance (number | null)required

    The balance at the end of the statement period.

    iban_number (string | null)

    Possible values: non-empty

    The International Bank Account Number

    minimum_due (number | null)required

    The minimum amount due for the statement period.

    period_end_date daterequired

    The end date of the statement period in ISO 8601 format.

    period_start_date daterequired

    The start date of the statement period in ISO 8601 format.

    routing_number (string | null)required

    Possible values: non-empty

    The routing number associated with the bank statement.

    statement_date daterequired

    The date of the statement in ISO 8601 format.

    statement_number (string | null)required

    Possible values: non-empty

    The unique identifier associated with the bank statement.

    swift (string | null)required

    Possible values: non-empty

    The unique identifier for a bank used in international transactions

    summaries object[]requireddeprecated

    Deprecated. Please use accounts.summaries instead. Summary information

  • Array [
  • name (string | null)

    Possible values: non-empty

    The title or label that captures the main information

    total (number | null)

    The overall amount calculated from all transactions

  • ]
  • account_numbers string[]required

    Possible values: non-empty

    The account number associated with the bank statement.

    routing_numbers string[]required

    Possible values: non-empty

    The routing number associated with the bank statement.

Loading...