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

- Base URL: `https://api.open-finance.ai/v2`
- URL: `https://api.open-finance.ai/v2/account-number-verification`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.open-finance.ai/oauth/token` scopes: `read:restricted_accounts`

## 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.dev/open-finance/apis/data.md) - [All operations](https://skmtc.dev/open-finance/apis/data/llms.txt) - [OpenAPI document](https://skmtc.dev/open-finance/apis/data/revisions/c18eafb2a770?raw)