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

# Get the org's funding address

> Where to send USDT to fund payouts, and the current balance there. Org-level, not per-order or per-batch — stable, safe to cache. Confirming a batch never returns a new address; it only moves whatever balance is already sitting here.



## OpenAPI

````yaml openapi-payouts-v2-0-0.json get /api/v2/payouts/funding-address
openapi: 3.0.3
info:
  title: Mansa Payout API — v2
  description: >
    API for registering Senders and Beneficiaries and for creating, funding, and
    tracking cross-border payout batches.


    ## Rate Limiting

    - 100 requests per minute per API key

    - Specific endpoints may have additional limits


    ## Security

    - All endpoints require authentication

    - Sender and Beneficiary profiles must clear KYC/KYB review (`status:
    "ready"`) before they can be used on an order


    ## Error Handling

    This API returns Nest's default error shape rather than a custom envelope.


    - **2xx** — The request succeeded.

    - **4xx** — The request failed due to a problem with the information
    provided.

    - **5xx** — A problem occurred on our servers or with an upstream
    dependency.


    Most errors have the shape:


    ```json

    {
      "statusCode": 400,
      "message": "..."
    }

    ```


    A `422` from a validation failure returns an array of per-field messages
    instead of one string:


    ```json

    {
      "statusCode": 422,
      "message": ["legal_name should not be empty", "country_code must be a valid ISO 3166-1 alpha-2 code"]
    }

    ```
  version: v2
  contact:
    name: Mansa API Support
    email: api-support@mansa.io
    url: https://docs.mansa.io
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
  - url: https://api.mansa.xyz
    description: Production server
  - url: https://sandbox-api.mansa.xyz
    description: Sandbox server
security:
  - ApiKeyAuth: []
    BearerAuth: []
tags:
  - name: Organizations
    description: Product entitlement checks
  - name: Senders
    description: Registering and verifying the org's own paying entities
  - name: Beneficiaries
    description: Registering and verifying who gets paid
  - name: Funding
    description: The org's USDT funding address and balance
  - name: Payouts
    description: Creating, funding, and tracking payout batches and orders
paths:
  /api/v2/payouts/funding-address:
    get:
      tags:
        - Funding
      summary: Get the org's funding address
      description: >-
        Where to send USDT to fund payouts, and the current balance there.
        Org-level, not per-order or per-batch — stable, safe to cache.
        Confirming a batch never returns a new address; it only moves whatever
        balance is already sitting here.
      operationId: getFundingAddress
      responses:
        '200':
          description: Funding address
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FundingAddress'
              examples:
                default:
                  value:
                    chain: TRON
                    network: TRC20
                    asset: USDT
                    address: T...
                    contract_address: T...
                    balance:
                      available: '0'
                      total: '0'
                    gas_balance:
                      available: '0'
                      total: '0'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/ServerError'
components:
  schemas:
    FundingAddress:
      type: object
      properties:
        chain:
          type: string
          description: Human-readable chain name, e.g. "TRON"
          example: TRON
        network:
          type: string
          enum:
            - TRC20
            - ERC20
          description: Not caller-selectable
        asset:
          type: string
          example: USDT
          description: Always "USDT" today
        address:
          type: string
          description: This org's own deposit wallet
        contract_address:
          type: string
          description: The asset's own on-chain contract address — distinct from `address`.
        balance:
          allOf:
            - $ref: '#/components/schemas/BalancePair'
          description: USDT balance at `address`.
        gas_balance:
          allOf:
            - $ref: '#/components/schemas/BalancePair'
          description: >-
            Native-token balance (e.g. TRX) at the same wallet — needed for
            outbound gas.
      required:
        - chain
        - network
        - asset
        - address
        - contract_address
        - balance
        - gas_balance
    BalancePair:
      type: object
      properties:
        available:
          type: string
        total:
          type: string
      required:
        - available
        - total
    NestErrorResponse:
      type: object
      description: Nest's default error envelope
      properties:
        statusCode:
          type: integer
          example: 400
        message:
          type: string
          example: sender not found
      required:
        - statusCode
        - message
      example:
        statusCode: 400
        message: sender not found
  responses:
    Unauthorized:
      description: Authentication required or invalid credentials
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/NestErrorResponse'
          examples:
            default:
              value:
                statusCode: 401
                message: Unauthorized
    RateLimited:
      description: Rate limit exceeded
      headers:
        X-RateLimit-Limit:
          description: Request limit per window
          schema:
            type: integer
        X-RateLimit-Remaining:
          description: Remaining requests in window
          schema:
            type: integer
        X-RateLimit-Reset:
          description: UNIX epoch seconds when the rate limit resets
          schema:
            type: integer
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/NestErrorResponse'
          examples:
            default:
              value:
                statusCode: 429
                message: Too many requests
    ServerError:
      description: Internal server or upstream error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/NestErrorResponse'
          examples:
            default:
              value:
                statusCode: 500
                message: Internal server error
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        ES256 JWT signed by the private key registered to the API key above.
        Claims: sub (=API key), uri, nbf, iat, exp, and bodyHash (HMAC-SHA512 of
        uri + rawBody + nbf using a shared secret, base64).

````