Skip to main content

Get Bank Statements

GET 

/api/v8/partner/bank-statements

Get Bank Statements

Request

Query Parameters

    meta.tags array

    Return documents containing these tags.

    Example: a
    meta.external_id string

    Return documents with this meta.external_id.

    Example: 123f-2aa-33cc
    created_date__gt string

    Return documents created after this date and time in ISO 8601 format.

    Example: 2022-05-03 00:00:00
    created_date__lt string

    Return documents created before this date and time in ISO 8601 format.

    Example: 2023-03-23 00:00:00
    created_date__gte string

    Return documents created beginning at this date and time in ISO 8601 format.

    Example: 2022-04-24 00:00:00
    created_date__lte string

    Return documents created on and before this date and time in ISO 8601 format.

    Example: 2020-10-15 00:00:00
    updated_date__gt string

    Return documents updated after this date and time in ISO 8601 format.

    Example: 2023-07-25 00:00:00
    updated_date__lt string

    Return documents updated before this date and time in ISO 8601 format.

    Example: 2019-03-18 00:00:00
    updated_date__gte string

    Return documents updated beginning at this date and time in ISO 8601 format.

    Example: 2020-02-03 00:00:00
    updated_date__lte string

    Return documents updated on and before this date and time in ISO 8601 format.

    Example: 2023-01-03 00:00:00
    page integer

    Default value: 1

    The page number. The response is capped to maximum of 50 results per page.

    page_size integer

    Default value: 50

    The number of Documents per page.

    Example: 10
    bounding_boxes boolean

    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

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

    q string

    Case sensitive. Return documents with this text or any extracted fields matching the value. Use asterisk for partial matches, e.g. q=Walmart* will return documents with either Walmart in ocr text or any extracted field containing Walmart.

    Example: Starbucks
    track_total_results boolean

    Whether to always return accurate count of results, true makes it slower.

Responses

A list of previously processed Bank Statements.

Schema
    anyOf
    count integerrequired

    The total number of results retrieved across all pages.

    next string

    The URL to the next page of results.

    previous string

    The URL to the previous page of results.

    results object[]required

    The collection of processed Bank Statement documents

  • Array [
  • external_id string

    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
    external_id string

    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

    Possible values: <= 1

    The average OCR score of the page.

    width integer

    The width of the page.

    height integer

    The height of the page.

  • ]
  • tags string[]

    Possible values: non-empty

    Default value: ``

    Tags associated with the document.

    ocr_score number

    Possible values: <= 1

    The average OCR score of the whole document.

    model string

    Possible values: non-empty

    The version of the model used to process the document.

    fraud object

    An object that contains additional information to identify fraud.

    score number

    Possible values: <= 1

    Confidence of Fraud Detector in it's prediction

    types string[]

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

    List of attributions which marked the document as fraud

    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.

  • ]
  • 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

    Possible values: non-empty

    The title or label that captures the main information

    total number

    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

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

    card_number string

    Possible values: non-empty

    A credit card number associated with this transaction.

    credit_amount number

    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

    The amount debited from this transaction.

    description string

    Possible values: non-empty

    The description of the transaction.

    transaction_id string

    Possible values: non-empty

    The unique identifier of the transaction.

    text string

    Possible values: non-empty

    The OCR text extracted from the transaction.

  • ]
  • number stringrequired

    Possible values: non-empty

    The account number associated with the bank statement.

    beginning_balance numberrequired

    The balance at the beginning of the statement period.

    ending_balance numberrequired

    The balance at the end of the statement period.

    iban_number string

    Possible values: non-empty

    The International Bank Account Number

  • ]
  • account_holder_address stringrequired

    Possible values: non-empty

    The address of the account holder.

    account_holder_name stringrequired

    Possible values: non-empty

    The name of the account holder.

    account_number stringrequired

    Possible values: non-empty

    The account number associated with the bank statement.

    account_type stringrequired

    Possible values: non-empty

    The type of account associated with the bank statement.

    account_vat_number stringrequired

    Possible values: non-empty

    The unique identifier for businesses used for tax purposes

    bank_address stringrequired

    Possible values: non-empty

    The address of the bank.

    bank_name stringrequired

    Possible values: non-empty

    The name of the bank.

    bank_vat_number stringrequired

    Possible values: non-empty

    The unique identifier assigned to a bank for tax purposes

    bank_website stringrequired

    Possible values: non-empty

    The URL for the website of the bank.

    beginning_balance numberrequired

    The balance at the beginning of the statement period.

    currency_code stringrequired

    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 numberrequired

    The balance at the end of the statement period.

    iban_number string

    Possible values: non-empty

    The International Bank Account Number

    minimum_due numberrequired

    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 stringrequired

    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 stringrequired

    Possible values: non-empty

    The unique identifier associated with the bank statement.

    swift stringrequired

    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

    Possible values: non-empty

    The title or label that captures the main information

    total number

    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...