Zai

Zai Sub Wallets API

The Sub-wallets API from Zai — 9 operation(s) for sub-wallets.

GitHub OpenAPI

Operations 11

GET /sub_wallets/{account_id} List Sub-wallets #
POST /sub_wallets Create Sub-wallet #
GET /sub_wallets/{id} Show Sub-wallet #
DELETE /sub_wallets/{id} Redact Sub-wallet #
PATCH /sub_wallets/{id} Update Sub-wallet #
PATCH /sub_wallets/transfer Fund transfers #
GET /sub_wallets/{id}/transactions List Sub-wallet transactions #
POST /sub_wallets/{id}/bill_payment Pay a Bill #
POST /sub_wallets/{id}/withdraw Withdraw Funds #
GET /sub_wallets/{id}/users Show Sub-wallet User #
GET /sub_wallets/{id}/wallet_accounts Show the Wallet Account of a Sub-wallet #

Documentation

📖
Documentation
https://developer.hellozai.com/docs
📖
APIReference
https://developer.hellozai.com/reference/overview
📖
Authentication
https://developer.hellozai.com/reference/token
📖
Documentation
https://developer.hellozai.com/reference/overview-va
📖
APIReference
https://developer.hellozai.com/reference/overview-va
📖
Documentation
https://developer.hellozai.com/docs/payto
📖
APIReference
https://developer.hellozai.com/reference/overview-1
📖
Documentation
https://developer.hellozai.com/reference/async-overview
📖
APIReference
https://developer.hellozai.com/reference/async-overview

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/zai/refs/heads/main/openapi/zai-sub-wallets-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/zai-sub-wallets-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

zai-sub-wallets-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Assembly Sub Wallets API
  description: Assembly (formely PromisePay) is a powerful payments engine custom-built for platforms and marketplaces.
  version: '2.3'
  contact:
    email: support@assemblypayments.com
    url: http://docs.assemblypayments.com/
servers:
- url: https://test.api.promisepay.com
  description: Pre-live environment
- url: https://secure.api.promisepay.com
  description: Production environment
- url: https://au-0000.sandbox.auth.assemblypay.com
  description: Pre-Live (Sandbox) Auth issuing server and API
- url: https://au-0000.auth.assemblypay.com
  description: Production Auth issuing server and API
- description: SwaggerHub API Auto Mocking
  url: https://virtserver.swaggerhub.com/AssemblyPlatforms/assembly-api/2.3
security:
- oAuth2ClientCredentials: []
tags:
- name: Sub-wallets
paths:
  /sub_wallets/{account_id}:
    get:
      tags:
      - Sub-wallets
      summary: List Sub-wallets
      description: List all the sub-wallets that belong to a user's wallet account. These are specified by the wallet `account_id`.
      operationId: listSubWallets
      parameters:
      - name: account_id
        in: path
        description: Wallet Account Id
        required: true
        style: simple
        explode: false
        schema:
          type: string
          default: 901d8cd0-6af3-0138-967d-0a58a9feac04
        example: 901d8cd0-6af3-0138-967d-0a58a9feac04
      - name: offset
        in: query
        description: Number of records to offset. Required for pagination.
        required: false
        style: form
        explode: true
        schema:
          minimum: 0
          type: integer
          default: 0
      - name: limit
        in: query
        description: Number of records to retrieve. Up to 200.
        required: false
        style: form
        explode: true
        schema:
          maximum: 200
          minimum: 1
          type: integer
          default: 10
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sub_wallets'
              examples:
                response:
                  value:
                    sub_wallets:
                    - id: 8665ee43-d350-4276-ac04-1031029faa53
                      name: Investment
                      active: true
                      created_at: '2019-04-29 02:42:31.536000+00:00'
                      updated_at: '2020-05-03 12:01:02.254000+00:00'
                      balance: 663337
                      currency: AUD
                      links:
                        self: /sub_wallets/8665ee43-d350-4276-ac04-1031029faa5
                        users: /sub_wallets/8665ee43-d350-4276-ac04-1031029faa53/users
                        transactions: /sub_wallets/8665ee43-d350-4276-ac04-1031029faa53/transactions
                        wallet_accounts: /sub_wallets/8665ee43-d350-4276-ac04-1031029faa53/wallet_accounts
                    links:
                      self: /sub_wallets
                    meta:
                      limit: 10
                      offset: 0
                      total: 1
        '422':
          description: unprocessable content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sub_wallet_error_responseBody'
              examples:
                feature configuration not enabled:
                  value:
                    errors:
                      sub_wallets:
                      - feature not available
                when account_id not given:
                  value:
                    errors:
                      account_id:
                      - required field missing
                when account_id format is invalid:
                  value:
                    errors:
                      account_id:
                      - invalid format
                when account_id is invalid i.e., does not exist:
                  value:
                    errors:
                      account_id:
                      - invalid
                when account_id belongs to a different marketplace:
                  value:
                    errors:
                      account_id:
                      - must belong to the marketplace
  /sub_wallets:
    post:
      tags:
      - Sub-wallets
      summary: Create Sub-wallet
      description: Create a sub-wallet for a user's wallet account.This is specified by the wallet `account_id`. Use sub-wallets as a part of building your own scheduling and workflow.  Create as many as you want to manage, with no limits to the amount.
      operationId: createSubWallet
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/sub_wallet_create_requestBody'
        required: true
      responses:
        '201':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sub_wallet_create_responseBody'
              examples:
                response:
                  value:
                    sub_wallets:
                      id: 8665ee43-d350-4276-ac04-1031029faa53
                      name: Investment
                      active: true
                      created_at: '2019-04-29 02:42:31.536000+00:00'
                      updated_at: '2020-05-03 12:01:02.254000+00:00'
                      balance: 0
                      currency: AUD
                      links:
                        self: /sub_wallets/8665ee43-d350-4276-ac04-1031029faa5
                        users: /sub_wallets/8665ee43-d350-4276-ac04-1031029faa53/users
                        wallet_accounts: /sub_wallets/8665ee43-d350-4276-ac04-1031029faa53/wallet_accounts
        '422':
          description: unprocessable content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sub_wallet_error_responseBody'
              examples:
                feature configuration not enabled:
                  value:
                    errors:
                      sub_wallets:
                      - feature not available
                when account_id not given in request body:
                  value:
                    errors:
                      account_id:
                      - required field missing
                when account_id format is invalid:
                  value:
                    errors:
                      account_id:
                      - invalid format
                when account_id is invalid i.e., does not exist:
                  value:
                    errors:
                      account_id:
                      - invalid
                when account_id belongs to a different marketplace:
                  value:
                    errors:
                      account_id:
                      - must belong to the marketplace
  /sub_wallets/{id}:
    get:
      tags:
      - Sub-wallets
      summary: Show Sub-wallet
      description: Show details of a specific sub-wallet using the given`:id`.
      operationId: showSubWallet
      parameters:
      - name: id
        in: path
        description: sub-wallet ID
        required: true
        style: simple
        explode: false
        schema:
          type: string
          example: c66a1bec-4ca5-418c-8b0a-5513819576ee
          default: c66a1bec-4ca5-418c-8b0a-5513819576ee
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sub_wallet'
              examples:
                response:
                  value:
                    sub_wallets:
                      id: c66a1bec-4ca5-418c-8b0a-5513819576ee
                      name: medical
                      active: true
                      balance: 0
                      created_at: c66a1bec-4ca5-418c-8b0a-5513819576ee
                      updated_at: c66a1bec-4ca5-418c-8b0a-5513819576ee
                      currency: AUD
                      links:
                        self: /sub_wallets/c66a1bec-4ca5-418c-8b0a-5513819576ee
                        users: /sub_wallets/c66a1bec-4ca5-418c-8b0a-5513819576ee/users
                        transactions: /sub_wallets/c66a1bec-4ca5-418c-8b0a-5513819576ee/transactions
                        wallet_accounts: /sub_wallets/c66a1bec-4ca5-418c-8b0a-5513819576ee/wallet_accounts
        '422':
          description: unprocessable content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sub_wallet_error_responseBody'
              examples:
                feature configuration not enabled:
                  value:
                    errors:
                      sub_wallets:
                      - feature not available
                id not provided:
                  value:
                    errors:
                      id:
                      - required field missing
                id format is invalid:
                  value:
                    errors:
                      id:
                      - invalid format
                id is invalid:
                  value:
                    errors:
                      id:
                      - invalid
                id belongs to a different marketplace:
                  value:
                    errors:
                      id:
                      - must belong to the marketplace
    delete:
      tags:
      - Sub-wallets
      summary: Redact Sub-wallet
      description: Redact a sub-wallet using the given `:id`. Only sub-wallets with zero balance can be redacted. Once this is done, the sub-wallet can no longer be used as a funding source.
      operationId: deleteSubWallet
      parameters:
      - name: id
        in: path
        description: sub-wallet ID
        required: true
        style: simple
        explode: false
        schema:
          type: string
          example: c66a1bec-4ca5-418c-8b0a-5513819576ee
          default: c66a1bec-4ca5-418c-8b0a-5513819576ee
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sub_wallet'
              examples:
                response:
                  value:
                    sub_wallets:
                      id: c66a1bec-4ca5-418c-8b0a-5513819576ee
                      name: medical
                      active: false
                      balance: 0
                      created_at: c66a1bec-4ca5-418c-8b0a-5513819576ee
                      updated_at: c66a1bec-4ca5-418c-8b0a-5513819576ee
                      currency: AUD
                      links:
                        self: /sub_wallets/c66a1bec-4ca5-418c-8b0a-5513819576ee
                        users: /sub_wallets/c66a1bec-4ca5-418c-8b0a-5513819576ee/users
                        transactions: /sub_wallets/c66a1bec-4ca5-418c-8b0a-5513819576ee/transactions
                        wallet_accounts: /sub_wallets/c66a1bec-4ca5-418c-8b0a-5513819576ee/wallet_accounts
        '422':
          description: unprocessable content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sub_wallet_error_responseBody'
              examples:
                feature configuration not enabled:
                  value:
                    errors:
                      sub_wallets:
                      - feature not available
                id not provided:
                  value:
                    errors:
                      id:
                      - required field missing
                id format is invalid:
                  value:
                    errors:
                      id:
                      - invalid format
                id is invalid:
                  value:
                    errors:
                      id:
                      - invalid
                id belongs to a different marketplace:
                  value:
                    errors:
                      id:
                      - must belong to the marketplace
                id is already redacted:
                  value:
                    errors:
                      base:
                      - unable to process request, sub-wallet already deleted
                balance of sub-wallet is non-zero:
                  value:
                    errors:
                      base:
                      - unable to delete sub-wallet with non-zero balance
    patch:
      tags:
      - Sub-wallets
      summary: Update Sub-wallet
      description: Update an existing sub-wallet using the given `:id`. You can change the `name` of an enabled sub-wallet. You can change the  `active` status of a `redacted` sub-wallet.
      operationId: updateSubWallet
      parameters:
      - name: id
        in: path
        description: sub-wallet ID
        required: true
        style: simple
        explode: false
        schema:
          type: string
          example: c66a1bec-4ca5-418c-8b0a-5513819576ee
          default: c66a1bec-4ca5-418c-8b0a-5513819576ee
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/sub_wallets_id_body'
            examples:
              bothInput:
                summary: update both name and active
                value:
                  name: Investment Fund
                  active: true
              activeInput:
                summary: enable redacted subwallet
                value:
                  active: true
              nameInput:
                summary: update name
                value:
                  name: Investment Fund
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sub_wallet'
              examples:
                response:
                  value:
                    sub_wallets:
                      id: c66a1bec-4ca5-418c-8b0a-5513819576ee
                      name: Investment Fund
                      active: true
                      balance: 0
                      created_at: c66a1bec-4ca5-418c-8b0a-5513819576ee
                      updated_at: c66a1bec-4ca5-418c-8b0a-5513819576ee
                      currency: AUD
                      links:
                        self: /sub_wallets/c66a1bec-4ca5-418c-8b0a-5513819576ee
                        users: /sub_wallets/c66a1bec-4ca5-418c-8b0a-5513819576ee/users
                        transactions: /sub_wallets/c66a1bec-4ca5-418c-8b0a-5513819576ee/transactions
                        wallet_accounts: /sub_wallets/c66a1bec-4ca5-418c-8b0a-5513819576ee/wallet_accounts
        '422':
          description: unprocessable content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sub_wallet_error_responseBody'
              examples:
                feature configuration not enabled:
                  value:
                    errors:
                      sub_wallets:
                      - feature not available
                id not provided:
                  value:
                    errors:
                      id:
                      - required field missing
                id format is invalid:
                  value:
                    errors:
                      id:
                      - invalid format
                id is invalid:
                  value:
                    errors:
                      id:
                      - invalid
                id belongs to a different marketplace:
                  value:
                    errors:
                      id:
                      - must belong to the marketplace
                invalid field names or no parameters given:
                  value:
                    errors:
                      base:
                      - unable to process request
                invalid value for provided active field:
                  value:
                    errors:
                      base:
                      - invalid value provided
                attempting to update name for redacted sub-wallet:
                  value:
                    errors:
                      base:
                      - unable to process request, sub wallet already deleted
  /sub_wallets/transfer:
    patch:
      tags:
      - Sub-wallets
      summary: Fund transfers
      description: Fund transfers between a wallet account and its sub-wallet as well as between any sub-wallets that belong to the same wallet account. The `source` and `destination` accounts must be `active` and use the same currency.
      operationId: transferSubWallet
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/sub_wallet_transfer_requestBody'
        required: true
      responses:
        '201':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sub_wallet_transfer_responseBody'
              examples:
                response:
                  value:
                    transactions:
                      id: b8049d20-ba41-013a-bbc8-0a58a9feac03
                      created_at: '2022-05-20 08:06:47.228000+00:00'
                      updated_at: '2022-05-20 08:06:47.423000+00:00'
                      description: Debit of $10.00 from Wallet Account for Credit of $10.00 to Sub-wallet Account
                      type: fund_transfer
                      type_method: misc
                      state: successful
                      user_id: aadd608d3926dc2a0e7499d80c92c03f
                      user_name: First1653026421 LastName
                      account_id: 0acef200-ba30-013a-1231-0a58a9feac03
                      account_type: wallet_account
                      amount: 1000
                      currency: AUD
                      debit_credit: debit
                      marketplace:
                        group_name: null
                        name: platform test-user-1653026421
                        short_name: null,
                        uuid: b6f2f40e-9f83-43be-9e70-25692bccc029
                      related:
                        transactions:
                        - id: b804aef0-ba41-013a-7c6a-0a58a9feac03
                          account_id: df00f819-57d2-4d97-afdc-78a4f9d92535
                          account_type: sub_wallet_account
                          user_id: aadd608d3926dc2a0e7499d80c92c03f
                          user_name: First1653026421 LastName
                      links:
                        self: /sub_wallets/transfer
        '422':
          description: unprocessable content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sub_wallet_error_responseBody'
              examples:
                feature configuration not enabled:
                  value:
                    errors:
                      sub_wallets:
                      - feature not available
                source not provided:
                  value:
                    errors:
                      source:
                      - required field missing
                destination not provided:
                  value:
                    errors:
                      destination:
                      - required field missing
                amount not provided:
                  value:
                    errors:
                      amount:
                      - required field missing
                source and destination are both wallet accounts:
                  value:
                    errors:
                      base:
                      - invalid source or destination
                source is not a wallet account or sub-wallet account:
                  value:
                    errors:
                      base:
                      - invalid source or destination
                destination is not a wallet account or sub-wallet account:
                  value:
                    errors:
                      base:
                      - invalid source or destination
                source is a redacted sub-wallet:
                  value:
                    errors:
                      source:
                      - unable to process request, sub-wallet already deleted
                destination is a redacted sub-wallet:
                  value:
                    errors:
                      destination:
                      - unable to process request, sub-wallet already deleted
                source does not have enough balance:
                  value:
                    errors:
                      base:
                      - The account you're transacting from does not have enough funds available
                source and destination belong to different marketplace:
                  value:
                    errors:
                      base:
                      - You can't transact between marketplaces
                source and destination are from different users:
                  value:
                    errors:
                      base:
                      - You cannot move funds to someone else's sub-wallet account
                source and destination have different currencies:
                  value:
                    errors:
                      base:
                      - You cannot transact across different currencies
  /sub_wallets/{id}/transactions:
    get:
      tags:
      - Sub-wallets
      summary: List Sub-wallet transactions
      description: List all transactions of a sub-wallet using the given `:id`.
      operationId: showSubWalletTransactions
      parameters:
      - name: id
        in: path
        description: sub-wallet ID
        required: true
        style: simple
        explode: false
        schema:
          type: string
          example: c66a1bec-4ca5-418c-8b0a-5513819576ee
          default: c66a1bec-4ca5-418c-8b0a-5513819576ee
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sub_wallet_transactions_index'
              examples:
                response:
                  value:
                    transactions:
                    - id: 0546ef82-5e16-4e52-9978-c9e2fcc07641
                      created_at: '2022-05-20 08:06:47.228000+00:00'
                      updated_at: '2022-05-20 08:06:47.423000+00:00'
                      description: Debit of $10.00 from Wallet Account for Credit of $10.00 to Sub-wallet Account
                      type: fund_transfer
                      type_method: misc
                      state: successful
                      user_id: aadd608d3926dc2a0e7499d80c92c03f
                      user_name: First1653026421 LastName
                      account_id: 0acef200-ba30-013a-1231-0a58a9feac03
                      account_type: wallet_account
                      amount: 1000
                      currency: AUD
                      debit_credit: debit
                      marketplace:
                        group_name: null
                        name: platform test-user-1653026421
                        short_name: null,
                        uuid: b6f2f40e-9f83-43be-9e70-25692bccc029
                      related:
                        transactions:
                        - id: b804aef0-ba41-013a-7c6a-0a58a9feac03
                          account_id: df00f819-57d2-4d97-afdc-78a4f9d92535
                          account_type: sub_wallet_account
                          user_id: aadd608d3926dc2a0e7499d80c92c03f
                          user_name: First1653026421 LastName
                    meta:
                      limit: 10
                      offset: 0
                      total: 1
                    links:
                      self: /sub_wallets/0546ef82-5e16-4e52-9978-c9e2fcc07641/transactions
        '422':
          description: unprocessable content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sub_wallet_error_responseBody'
              examples:
                feature configuration not enabled:
                  value:
                    errors:
                      sub_wallets:
                      - feature not available
                id not provided:
                  value:
                    errors:
                      id:
                      - required field missing
                id format is invalid:
                  value:
                    errors:
                      id:
                      - invalid format
                id is invalid:
                  value:
                    errors:
                      id:
                      - invalid
                id belongs to a different marketplace:
                  value:
                    errors:
                      id:
                      - must belong to the marketplace
  /sub_wallets/{id}/bill_payment:
    post:
      tags:
      - Sub-wallets
      summary: Pay a Bill
      description: Pay a bill to a specified BPAY account that's associated with its `account_id` by withdrawing funds from a sub-wallet using the given `id`.
      operationId: billPaymentSubWallet
      parameters:
      - name: id
        in: path
        description: sub-wallet ID
        required: true
        style: simple
        explode: false
        schema:
          type: string
          default: 901d8cd0-6af3-0138-967d-0a58a9feac04
        example: 8a31ebfa-421b-4cbb-9241-632f71b3778a
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/bill_payment_requestBody'
        required: true
      responses:
        '201':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/single_disbursement'
              examples:
                response:
                  value:
                    disbursements:
                      id: 8a31ebfa-421b-4cbb-9241-632f71b3778a
                      amount: 173
                      currency: AUD
                      created_at: '2020-05-09 07:09:03.383000+00:00'
                      updated_at: '2020-05-09 07:09:04.585000+00:00'
                      state: pending
                      to: BPay Account
                      account_name: My Water Company
                      biller_name: ABC Water
                      biller_code: 123456
                      crn: 9.87654321E8
                      links:
                        transactions: /disbursements/8a31ebfa-421b-4cbb-9241-632f71b3778a/transactions
                        wallet_accounts: /disbursements/8a31ebfa-421b-4cbb-9241-632f71b3778a/wallet_accounts
                        bank_accounts: /disbursements/8a31ebfa-421b-4cbb-9241-632f71b3778a/bank_accounts
                        bpay_accounts: /disbursements/8a31ebfa-421b-4cbb-9241-632f71b3778a/bpay_accounts
                        paypal_accounts: /disbursements/8a31ebfa-421b-4cbb-9241-632f71b3778a/paypal_accounts
                        items: /disbursements/8a31ebfa-421b-4cbb-9241-632f71b3778a/items
                        users: /disbursements/8a31ebfa-421b-4cbb-9241-632f71b3778a/users
        '422':
          description: unprocessable content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sub_wallet_error_responseBody'
              examples:
                feature configuration not enabled:
                  value:
                    errors:
                      sub_wallets:
                      - feature not available
                payout feature configuration not enabled:
                  value:
                    errors:
                      payout:
                      - feature not available
                id not provided:
                  value:
                    errors:
                      id:
                      - required field missing
                id format is invalid:
                  value:
                    errors:
                      id:
                      - invalid format
                id is invalid:
                  value:
                    errors:
                      id:
                      - invalid
                id belongs to a different marketplace:
                  value:
                    errors:
                      id:
                      - must belong to the marketplace
                id belongs to redacted sub-wallet:
                  value:
                    errors:
                      base:
                      - unable to process request, sub-wallet already deleted
                account_id is not provided:
                  value:
                    errors:
                      account_id:
                      - required field missing
                account_id format is invalid:
                  value:
                    errors:
                      account_id:
                      - invalid format
                account_id is not of a Bpay account:
                  value:
                    errors:
                      account_id:
                      - invalid destination account
                account_id is of a inactive Bpay account:
                  value:
                    errors:
                      account_id:
                      - invalid destination account
                amount is not provided:
                  value:
                    errors:
                      amount:
                      - required field missing
                amount is greater than sub-wallet balance:
                  value:
                    errors:
                      payout:
                      - Invalid disbursement amount.
                amount has a different currency:
                  value:
                    errors:
                      base:
                      - You cannot transact across different currencies
                reference_id is not unique:
                  value:
                    errors:
                      reference_id:
                      - Unable to process this request, reference_id must be unique for every bill payment request
  /sub_wallets/{id}/withdraw:
    post:
      tags:
      - Sub-wallets
      summary: Withdraw Funds
      description: Withdraw funds from a sub-wallet using the given `id` and move the specified amount to a disbursement account associated with the `account_id`.
      operationId: withdrawFundsSubWallet
      parameters:
      - name: id
        in: path
        description: sub-wallet ID
        required: true
        style: simple
        explode: false
        schema:
          type: string
          default: bd6e9c20-73f1-0138-fb91-0a58a9feac09
        example: bd6e9c20-73f1-0138-fb91-0a58a9feac09
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/sub_wallet_withdraw_requestBody'
        required: true
      responses:
        '201':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/single_disbursement'
              examples:
                response:
                  value:
                    disbursements:
                      id: 8a31ebfa-421b-4cbb-9241-632f71b3778a
                      reference_id: 7190770-1-2908
                      amount: 173
                      currency: AUD
                      created_at: '2020-05-09 07:09:03.383000+00:00'
                      updated_at: '2020-05-09 07:09:04.585000+00:00'
                      state: pending
                      to: Bank Account
                      bank_name: Test Bank Assembly
                      bank_account_name: Assembly seller71718579
                      bank_account_number: XXX130
                      bank_routing_number: XXXXX8
                      npp_payout_state: trying
                      links:
                     

# --- truncated at 32 KB (58 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/zai/refs/heads/main/openapi/zai-sub-wallets-api-openapi.yml