---
title: "Builds a Turkish IBAN from a 5-digit bank code and account number, computing ISO 7064 check digits."
method: GET
path: "/v1/tr/iban/build"
tags: ["Finance"]
---

# Builds a Turkish IBAN from a 5-digit bank code and account number, computing ISO 7064 check digits.

`GET /v1/tr/iban/build`

## Request

- Base URL: `https://api.temsor.com`
- URL: `https://api.temsor.com/v1/tr/iban/build`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

A Turkish IBAN is TR + 2 check digits + 5-digit bank code + 1 reserved digit + 16-character account. This pads the account on the left, defaults the reserved digit to 0, computes the mod-97 check digits, and resolves the bank name from the same national table used by IBAN validation when the code is known. Unknown bank codes still produce a structurally valid IBAN with bankName null — existence at the bank is not claimed.

**Credits per call:** 1 · **Operation id:** `tr_iban_olustur`

In the GET form every field is a query parameter; object and array fields are JSON-encoded.

## Query parameters

- `bankCode` string, required: 5-digit Turkish national bank / EFT code (e.g. 00062).
- `accountNumber` string, required: Account number, up to 16 alphanumeric characters (padded left with zeros).
- `reserved` string: Reserved BBAN digit after the bank code. Defaults to 0.

## Response `200`

Success

- object
  - `ok` unknown, required
  - `data` object, required
    - `iban` string, required
    - `formatted` string, required
    - `electronicFormat` string, required
    - `checkDigits` string, required
    - `bankCode` string, required
    - `bankName` string, nullable, required
    - `reserved` string, required
    - `accountNumber` string, required
    - `checksumValid` boolean, required
  - `meta` object
    - `credits` integer
    - `cached` boolean
    - `requestId` string
    - `durationMs` integer

## Other responses

- `400`: Error
- `401`: Error
- `402`: Error
- `429`: Rate limit exceeded — wait `Retry-After` seconds. The RateLimit headers are sent here too.

---

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