---
title: "Create an account information (bank linking) session. Returns connect_url for provider UI and session_id for polling/redirect."
method: POST
path: "/api/v1/merchants/{id}/account-information/sessions"
tags: ["Account Information"]
---

# Create an account information (bank linking) session. Returns connect_url for provider UI and session_id for polling/redirect.

`POST /api/v1/merchants/{id}/account-information/sessions`

Create an account information (bank linking) session. Returns connect_url for provider UI and session_id for polling/redirect.

## Path parameters

- `id` string, uuid, required — Merchant ID

## Request body

- AccountInformationCreateSessionInput — Request body for creating an account information (bank linking) session
  - `country` string — Bank account country to link. Currently only US is supported for account verification.
  - `redirect_url` string, uri — URL to redirect the user after completing the provider flow
  - `include_holder_identity` boolean — Include account holder identity (name, address, email, phone)
  - `include_transactions` boolean — Include transaction history
  - `transaction_days` union — Transaction history period in days
    - 90
    - 365
  - `include_statements` boolean — Include PDF bank statements
  - `statement_count` number — Number of statements to retrieve

## Response `201`

Created

- AccountInformationCreateSessionResponse
  - `success` boolean, required — Indicates if the request was successful
  - `data` object, required
    - `session_id` string, uuid, required — Session ID for internal use (polling status, confirm accounts)
    - `verification_token` string, required — Secure token for building public verification URLs. Only returned once, never stored. Use this in verification link URLs (not session_id).
    - `expires_at` string, date-time, required — When the session expires

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/banqzinc/apis/quidkey-api.md) · [All operations](https://skmtc.net/banqzinc/apis/quidkey-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/banqzinc/quidkey-api/revisions/f86d2bdbcb08/schema)