---
title: "Complete Add Bank"
method: POST
path: "/api/openbanking/complete-add-bank"
tags: ["openbanking"]
---

# Complete Add Bank

`POST /api/openbanking/complete-add-bank`

## Request

- Base URL: `https://api.earmarkiq.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.earmarkiq.app/api/openbanking/complete-add-bank`
- Auth: HTTP bearer

Complete the add-bank flow after the user returns from Finexer auth.
Checks consent status with retries, creates BankConnection + Account
records, triggers sync, and returns the new connection details.

Idempotency: per-consent_link_id lock prevents multi-browser race.
If a connection was already created for this consent_link_id, returns it.

## Request body

- CompleteAddBankRequest
  - `consent_link_id` string, required

## Response `200`

Successful Response

- CompleteAddBankResponse
  - `status` string, required
  - `synced_accounts` integer, required
  - `new_transactions` integer, required
  - `connections` BankConnectionResponse[], required
    - `id` string, required
    - `institution_id` string, nullable, required
    - `institution_name` string, nullable, required
    - `institution_logo_url` string, nullable, required
    - `account_name` string, nullable, required
    - `account_type` string, nullable, required
    - `sort_code` string, nullable, required
    - `account_number` string, nullable, required
    - `currency` string, required
    - `balance` number, nullable
    - `balance_updated` string, nullable
    - `status` string, required
    - `last_synced_at` string, nullable, required
    - `connected_at` string, required
    - `consent_expired` boolean
    - `consent_expires` string, nullable
    - `consent_last_authorised_at` string, nullable
    - `last_sync_status` string, nullable
    - `last_sync_error` string, nullable
    - `last_sync_attempted_at` string, nullable
    - `stale` boolean
  - `reason` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/earmarkiq/apis/earmark-api.md) · [All operations](https://skmtc.dev/earmarkiq/apis/earmark-api/llms.txt) · [OpenAPI document](https://skmtc.dev/earmarkiq/apis/earmark-api/revisions/4a2c41907105?raw)