> ## 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 My Chain

> Returns the chain configured for your organisation. If you have set a preferred chain it will be returned; otherwise the platform default chain is returned.



## OpenAPI

````yaml openapi-v2-0-0.json get /api/v2/liquidity/management/chain/me
openapi: 3.0.3
info:
  title: Mansa Liquidity API — v2
  description: >
    API for managing credit limits and whitelisted wallets for cross-border
    liquidity operations.


    ## Rate Limiting

    - 100 requests per minute per API key

    - Specific endpoints may have additional limits


    ## Security

    - All endpoints require authentication

    - KYC verification may be required depending on organization policy


    ## Error Handling

    This API uses HTTP status codes and a structured error envelope in the
    response body.


    - **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.


    When an error occurs, the response body has the shape:


    ```json

    {
      "error": {
        "type": "validation_error",
        "code": "missing_required_field",
        "message": "The 'amount' field is required.",
        "param": "amount",
        "doc_url": "https://docs.mansa.io/errors/missing_required_field",
        "request_id": "req_123456789"
      }
    }

    ```
  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: Onboarding
    description: V2 credit limit and whitelist operations
  - name: Management
    description: V2 settlement facilities, balances, withdrawal requests, and repayments
  - name: Utilization
    description: >-
      V2 drawdown intents, settlement confirmations, proofs, and document
      uploads
paths:
  /api/v2/liquidity/management/chain/me:
    get:
      tags:
        - Management
      summary: Get My Chain
      description: >-
        Returns the chain configured for your organisation. If you have set a
        preferred chain it will be returned; otherwise the platform default
        chain is returned.
      operationId: v2GetOrgChain
      responses:
        '200':
          description: The organisation's chain
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChainSingleResponse'
              examples:
                default:
                  value:
                    data:
                      id: 37361842-8d00-4f85-aaa2-5d0c014f303d
                      chain_blockchain_id: '2494104990'
                      is_testnet: false
                      description: null
                      chain_name: Tron
                      treasury_vault_id: null
                      chain_symbol: TRX
                      gas_token_id: a1b2c3d4-0000-0000-0000-ef1234567890
                      gas_token_legacy_id: TRX
                      funding_token_name: USDT
                      funding_token_address: TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
                      funding_token_id: b2c3d4e5-0000-0000-0000-1234567890ab
                      funding_token_legacy_id: USDT_TRON
                      address_format: TRON
                      initial_gas_amount: '10'
                      is_active: true
                      created_at: '2024-01-15T10:00:00Z'
                      updated_at: '2024-01-15T10:00:00Z'
                    status: 200
                    isSuccess: true
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/ServerError'
components:
  schemas:
    ChainSingleResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/ChainItem'
        status:
          type: integer
          example: 200
        isSuccess:
          type: boolean
          example: true
    ChainItem:
      type: object
      properties:
        id:
          type: string
          format: uuid
        chain_blockchain_id:
          type: string
          example: '2494104990'
        is_testnet:
          type: boolean
        description:
          type: string
          nullable: true
        chain_name:
          type: string
          example: TronShasta
        treasury_vault_id:
          type: string
          nullable: true
        chain_symbol:
          type: string
          example: TRX
        gas_token_id:
          type: string
          format: uuid
        gas_token_legacy_id:
          type: string
          example: TRX_TEST
        funding_token_name:
          type: string
          example: USDT
        funding_token_address:
          type: string
        funding_token_id:
          type: string
          format: uuid
        funding_token_legacy_id:
          type: string
        address_format:
          type: string
          example: EVM
          description: Address format used by this chain (e.g. EVM, SOLANA).
        initial_gas_amount:
          type: string
          nullable: true
          example: '0.5'
          description: >-
            Amount of gas token seeded to a borrower's wallet on their first
            loan. Null means no automatic gas seeding for this chain.
        is_active:
          type: boolean
          example: true
          description: >-
            Whether this chain is currently enabled for new loans and
            repayments.
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
    ErrorResponse:
      type: object
      description: Standard error envelope
      properties:
        error:
          $ref: '#/components/schemas/ErrorObject'
      required:
        - error
      additionalProperties: false
      example:
        error:
          type: validation_error
          code: missing_required_field
          message: The 'amount' field is required.
          param: amount
          doc_url: https://docs.mansa.io/errors/missing_required_field
          request_id: req_123456789
    ErrorObject:
      type: object
      properties:
        type:
          allOf:
            - $ref: '#/components/schemas/ErrorTypeEnum'
        code:
          type: string
          nullable: true
          description: Programmatic error code
        message:
          type: string
          nullable: true
          description: Human-readable error message
        param:
          type: string
          nullable: true
          description: Parameter related to the error, if applicable
        doc_url:
          type: string
          format: uri
          nullable: true
          description: Link to docs for this error
        request_id:
          type: string
          nullable: true
          description: Internal request identifier for support
      required:
        - type
      additionalProperties: false
    ErrorTypeEnum:
      type: string
      enum:
        - api_error
        - validation_error
        - auth_error
        - idempotency_error
        - rate_limit_error
  responses:
    Unauthorized:
      description: Authentication required or invalid credentials
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            invalid_token:
              value:
                error:
                  type: auth_error
                  code: invalid_token
                  message: Bearer token is missing or invalid.
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            not_found:
              value:
                error:
                  type: validation_error
                  code: resource_not_found
                  message: The requested resource does not exist.
    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/ErrorResponse'
          examples:
            too_many_requests:
              value:
                error:
                  type: rate_limit_error
                  code: too_many_requests
                  message: Too many requests. Please retry with exponential backoff.
    ServerError:
      description: Internal server or upstream error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            upstream_failure:
              value:
                error:
                  type: api_error
                  code: upstream_dependency_error
                  message: A dependency failed to process the request.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT token following RFC001 specification

````