Skip to main content

Get a Bank Statement

GET 

/api/v8/partner/bank-statements/:document_id

Veryfi's Get a Bank Statement endpoint allows you to retrieve a previously processed Bank Statement.

Request

Path Parameters

    document_id int64required

    The unique identifier of the document.

Query Parameters

    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.

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