---
title: "Generate synthetic IBANs"
method: POST
path: "/generate"
---

# Generate synthetic IBANs

`POST /generate`

## Request

- Base URL: `https://ibangen.com/api/v1`
- URL: `https://ibangen.com/api/v1/generate`
- Auth: API key in header `X-API-Key`

## Request body

- GenerateRequest
  - `country` string, required
  - `quantity` integer
  - `seed` string
  - `include_bank_details` boolean
  - `targeting` object
    - `city` string
    - `bank` string
    - `bic` string

## Response `200`

Generated rows

## Other responses

- `400`: Stable validation error
- `401`: Invalid API key
- `429`: Quota exhausted

---

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