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

## Request

- Base URL: `https://core.quidkey.com`
- URL: `https://core.quidkey.com/api/v1/merchants/{id}/account-information/sessions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/banqzinc/apis/quidkey-api/docs/api/v1/merchants/:id/account-information/sessions/post.ts> (a function with typed inputs; its response is checked against the schema)

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

## Changes

- **2026-06-17** `b372e7d5563d`: 1 info
  - endpoint added
- **2025-11-02** `919eb7a392aa`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/banqzinc/apis/quidkey-api/changes/api/v1/merchants/:id/account-information/sessions/post.md)

---

[API](https://skmtc.dev/banqzinc/apis/quidkey-api.md) - [All operations](https://skmtc.dev/banqzinc/apis/quidkey-api/llms.txt) - [OpenAPI document](https://skmtc.dev/banqzinc/apis/quidkey-api/revisions/f86d2bdbcb08?raw)