---
title: "Register UK bank account"
method: POST
path: "/v2/accounts/{accountId}/bank-accounts/uk-scan"
tags: ["Bank accounts"]
---

# Register UK bank account

`POST /v2/accounts/{accountId}/bank-accounts/uk-scan`

Register a new bank account with UK's sort code + account number (SCAN) scheme.

In UK banking, a sort code is a unique identifier used to route money transfers between banks and financial institutions. Its similar to a routing number in the US. It is a six-digit number that identifies both the bank and the specific branch. Each bank and branch has its own unique sort code. The first two digits identify the bank and the remaining 4 digits identify the branch.

To read about Pismo's banking offerings, see [Banking overview](https://developers.pismo.io/pismo-docs/docs/banking-overview).

This endpoint generates a <a href="https://developers.pismo.io/events/docs/intl-bankaccounts-intl-bankaccount-register-1">Bank account registered</a> event.

## Path parameters

- `accountId` string, required

## Headers

- `Authorization` string, required

## Request body

- IntlbankaccountsIntlBankAccountUkScanRequest
  - `scheme` IntlbankaccountsUkScanScheme, required
    - `account_number` string, required — Account number
    - `sort_code` string, required — In UK banking, a sort code is a unique identifier used to route money transfers between banks and financial institutions. Similar to a routing number in the US. It is a six-digit number that identifies both the bank and the specific branch office. Each bank branch office has its own unique sort code. The first two digits identity the bank and the remaining 4 digits identify the branch.
  - `metadata` Metadata — A set of key-value pairs used to store custom data or additional information.<br> **Note**: This field must not be used to send Personally Identifiable Information (PII), Payment Card Industry (PCI) data, or any sensitive/regulated information. Metadata fields are intended for operational, non-sensitive data only. For sensitive data, use the specific parameters designed for that purpose. For more information, refer to [Get started with Pismo APIs](https://developers.pismo.io/pismo-docs/reference/get-started-with-pismo-apis).

## Response `201`

Response

- IntlbankaccountsIntlBankAccountUkScanResponse
  - `account_id` integer — Account ID
  - `creation_datetime` string, date-time — Account creation date time displayed in ISO 8601 format `2023-04-12T23:20:50.52Z`.
  - `metadata` Metadata — A set of key-value pairs used to store custom data or additional information.<br> **Note**: This field must not be used to send Personally Identifiable Information (PII), Payment Card Industry (PCI) data, or any sensitive/regulated information. Metadata fields are intended for operational, non-sensitive data only. For sensitive data, use the specific parameters designed for that purpose. For more information, refer to [Get started with Pismo APIs](https://developers.pismo.io/pismo-docs/reference/get-started-with-pismo-apis).
  - `scheme` IntlbankaccountsUkScanScheme, required
    - `account_number` string, required — Account number
    - `sort_code` string, required — In UK banking, a sort code is a unique identifier used to route money transfers between banks and financial institutions. Similar to a routing number in the US. It is a six-digit number that identifies both the bank and the specific branch office. Each bank branch office has its own unique sort code. The first two digits identity the bank and the remaining 4 digits identify the branch.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `500` — Internal Server

---

[API](https://skmtc.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/revisions/935b62e16de4/schema)