---
title: "Check if a certain account is restricted"
method: POST
path: "/account-number-verification"
---

# Check if a certain account is restricted

`POST /account-number-verification`

## Request body

- object
  - `accountNumber` string — The bban account number to check, formatted as 'XX-XXX-XXXXX'
  - `accountIbanNumber` string — The iban account number to check, formatted as 'ILXXXXXXXXXXXXXXXXXXX'

## Response `200`

Response

- object
  - `status` 'RESTRICTED' | 'VALID' | 'INVALID' — Returns whether the account is restricted, and if not then if the account number is valid or not
  - `reason` 'BANK_INVALID' | 'BRANCH_INVALID' | 'ACCOUNT_INVALID' | 'BRANCH_CLOSED' | 'SHORT_ACCOUNT_NUMBER' — If the account is invalid, the reason will be displayed here

## Other responses

- `400` — Invalid request format or parameters
- `401` — Unauthorized access - Invalid access token
- `403` — Forbidden - Access token missing the required permissions to preform this action
- `404` — Not found - The route or resource were not found
- `500` — Internal server error

---

[API](https://skmtc.net/open-finance/apis/auth.md) · [All operations](https://skmtc.net/open-finance/apis/auth/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/open-finance/auth/versions/b4d401b65c3d/schema)