---
title: "Handle bank auth callback"
method: POST
path: "/api/finances/bank/callback"
tags: ["Finances - Bank"]
---

# Handle bank auth callback

`POST /api/finances/bank/callback`

## Request

- Base URL: `https://api.typless.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.typless.com/api/finances/bank/callback`
- Auth: none declared

## Request body

- BankCallbackRequest
  - `code` string, required
  - `state` string, required
  - `business_unit_id` string, uuid, nullable

## Response `200`

Successful Response

- BankConnectionDTO
  - `aggregate_id` string, uuid, required
  - `tenant_id` string, uuid, required
  - `business_unit_id` string, uuid, nullable
  - `aspsp_name` string, required
  - `aspsp_country` string, required
  - `bank_display_name` string, nullable
  - `status` string, required
  - `consent_expires_at` string, date-time, nullable
  - `last_synced_at` string, date-time, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `accounts` BankAccountDTO[]
    - `id` string, uuid, required
    - `uid_external` string, nullable
    - `iban` string, nullable
    - `currency` string, nullable
    - `account_name` string, nullable
    - `is_active` boolean

## Other responses

- `422`: Validation Error

---

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