imbawallet-com Balance API

openapi: 3.2.0
info:
  title: IMBA Partner Balance API
  version: 1.2.0
  summary: B2B Partner API for USDT settlement, cards, eSIM, gift cards, and KYT
  description: 'B2B Partner API. Production host `https://imbawallet.com` (no sandbox).


    - Human docs: `https://api-docs.imbawallet.com` (guides + FAQ)

    - Authenticate with `POST /auth/v1/partner/token` (assertion JWT), then call

    `POST /api/partner/` with `Authorization: Bearer `

    and a JSON body. Resource ids are body fields, not URL segments.

    - Amounts are decimal strings.

    - Response timestamps are UTC RFC 3339 with `Z`.

    - Request time fields accept RFC 3339 or unix seconds (not milliseconds).

    - Catalog calls (`/api/partner/gift_offers`, `/api/partner/esim_offers`,

    `/api/partner/card_products`) are live availability and the live USDT price.

    There is no `/quote` or `/availability` path.

    - Order lookup: `POST /api/partner/document_get`. Secrets via product calls

    after fulfillment (card JWE, gift `epin`, eSIM LPA) — not in webhooks

    except `card.otp`.

    - Card authorizations: `POST /api/partner/card_transactions`.

    Unfreeze: `POST /api/partner/card_unfreeze` (only a freeze by you or the cardholder).

    - Not in v1: purchase refund/cancel, card unload, card replacement.'
  contact:
    name: IMBA Partner Support
    email: support@imbawallet.com
  license:
    name: Proprietary
    url: https://imbawallet.com
servers:
- url: https://imbawallet.com
  description: Production
tags:
- name: Balance
  description: Partner settlement balance
paths:
  /api/partner/balance:
    post:
      operationId: getPartnerBalance
      tags:
      - Balance
      summary: Get partner settlement (ledger) balance
      description: 'Accounting balance in `currency` — not an on-chain wallet balance and

        not a virtual-card USD balance. `network` is not returned. Optional

        legacy `network` / `asset` query params are ignored if present.

        Commercial minimum first deposit is 1000 USDT (onboarding); the API

        does not extend credit.'
      parameters:
      - $ref: '#/components/parameters/currency'
      - $ref: '#/components/parameters/assetAlias'
      responses:
        '200':
          description: Ledger balance snapshot
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BalanceResponse'
        '401':
          $ref: '#/components/responses/Error'
        '403':
          $ref: '#/components/responses/Error'
components:
  responses:
    Error:
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
  parameters:
    assetAlias:
      name: assetAlias
      in: query
      required: false
      schema:
        type: string
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
    currency:
      name: currency
      in: query
      required: false
      schema:
        type: string
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
  schemas:
    BalanceResponse:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true