> ## Documentation Index
> Fetch the complete documentation index at: https://docs.otim.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create IBAN

> Issues a new IBAN for a verified Entity. The IBAN is linked to an Account, and any fiat deposited to it will be automatically converted and routed into that Account. The Entity must have completed verification (KYC/KYB) before an IBAN can be issued.



## OpenAPI

````yaml POST /ibans
openapi: 3.1.0
info:
  title: Otim Platform API
  version: v0
  description: >-
    API for managing accounts, entities, transfers, counterparties, and IBANs on
    the Otim platform.
servers:
  - url: https://api.otim.com/v0
security:
  - bearerAuth: []
paths:
  /ibans:
    post:
      tags: []
      summary: Create IBAN
      description: >-
        Issues a new IBAN for a verified Entity. The IBAN is linked to an
        Account, and any fiat deposited to it will be automatically converted
        and routed into that Account. The Entity must have completed
        verification (KYC/KYB) before an IBAN can be issued.
      operationId: createIban
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateIbanRequest'
      responses:
        '201':
          description: IBAN created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Iban'
        '400':
          description: Validation error (e.g., Entity not verified).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    CreateIbanRequest:
      type: object
      required:
        - entityId
        - accountId
        - currency
      properties:
        entityId:
          type: string
          description: The ID of the verified Entity to issue the IBAN for.
        accountId:
          type: string
          description: >-
            The ID of the Account that will receive funds deposited to this
            IBAN.
        currency:
          type: string
          description: The fiat currency for the IBAN.
          enum:
            - USD
            - EUR
            - GBP
            - JPY
            - CAD
            - AUD
            - CHF
    Iban:
      type: object
      properties:
        id:
          type: string
          example: iban_01JA1B2C3D4E5F6G7H8J9K0L
        entityId:
          type: string
          example: ent_01JA1B2C3D4E5F6G7H8J9K0L
        accountId:
          type: string
          example: acc_01JA1B2C3D4E5F6G7H8J9K0L
        iban:
          type: string
          example: GB29 NWBK 6016 1331 9268 19
        bic:
          type: string
          example: NWBKGB2L
        bankName:
          type: string
          example: Otim Financial Services
        currency:
          type: string
          description: The fiat currency this IBAN accepts.
          example: EUR
        status:
          type: string
          enum:
            - active
            - inactive
          example: active
        createdAt:
          type: string
          format: date-time
          example: '2025-01-15T12:00:00Z'
    Error:
      type: object
      properties:
        error:
          type: string
        code:
          type: string
          description: A machine-readable error code.
        details:
          type: object
          nullable: true
          description: Additional context about the error.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key prefixed with `sk_`.

````