---
title: "Create a Bank Document Verification"
method: POST
path: "/v2/bank-document-verifications"
tags: ["Bank document verifications (Coming soon)"]
---

# Create a Bank Document Verification

`POST /v2/bank-document-verifications`

## Request

- Base URL: `https://api.ubble.ai`
- URL: `https://api.ubble.ai/v2/bank-document-verifications`
- Auth: none declared
- TypeScript: <https://skmtc.dev/ubble/apis/checkout-com-identity-verification/docs/v2/bank-document-verifications/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a Bank Document Verification

## Request body

- BankDocumentVerificationInputPost
  - `user_journey_id` string: User journey unique identifier.
  - `applicant_id` string: Business Applicant unique identifier.
  - `webhook_url` string, uri
  - `declared_data` BankDocumentVerificationDeclaredData
    - `registered_name` string, required
    - `trading_name` string, required

## Response `201`

Bank Document Verification created successfully

- BankDocumentVerificationOutputPost
  - `id` string: Bank Document Verification unique identifier.
  - `status` 'created' | 'quality_checks_in_progress' | 'checks_in_progress' | 'approved' | 'declined' | 'retry_required' | 'inconclusive': Bank Document Verification status.
  - `response_codes` ResponseCodes[]
    - `code` integer, required: The numeric code of the response code.
    - `summary` string, required: A descriptive code of the response code.
  - `risk_labels` RiskLabel[]: Risk assessment labels
  - `bank_document` BankDocument
    - `bank_account_number` string
    - `bank_routing_number` string
    - `account_type` 'checking' | 'savings': Type of account.
    - `company_name` string
    - `bank_name` string
    - `issue_date` string, date
    - `document_type` 'bank_statement' | 'bank_letter' | 'bank_check': Type of document.
    - `company_address` Address
      - `address_line1` string
      - `address_line2` string
      - `city` string
      - `state` string
      - `zip` string
      - `country` string, ISO 3166-1 alpha-2
  - `_links` BankDocumentVerificationLinks
    - `self` HalLink, required
      - `href` string, uri, required
  - `user_journey_id` string: User journey unique identifier.
  - `applicant_id` string: Business Applicant unique identifier.
  - `webhook_url` string, uri
  - `declared_data` BankDocumentVerificationDeclaredData
    - `registered_name` string, required
    - `trading_name` string, required
  - `created_on` string, date-time, required: UTC Date time when the resource was created
  - `modified_on` string, date-time, required: UTC Date time when the resource was modified

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `422`: Unprocessable entity
- `500`: Internal server error
- `503`: Service unavailable

---

[API](https://skmtc.dev/ubble/apis/checkout-com-identity-verification.md) - [All operations](https://skmtc.dev/ubble/apis/checkout-com-identity-verification/llms.txt) - [OpenAPI document](https://skmtc.dev/ubble/apis/checkout-com-identity-verification/revisions/739e9da12584?raw)