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

# Get a deposit address

> Your static address for receiving stablecoins on a network. Every call for the same network returns the same address, so no `Idempotency-Key` is needed. A transfer below 1 USDT or 1 USDC is lost — it is never credited and never appears as a collection.



## OpenAPI

````yaml /v2/openapi.json post /deposit-addresses
openapi: 3.1.0
info:
  title: Jenzy Hermes Multi-asset API
  version: 2.0.0
  description: >-
    Hold and pay out across the assets enabled for your organization. Every
    amount is an exact decimal string beside an `asset` field. Authenticate with
    the same `jz_live_…` API key as `/v1`.
servers:
  - url: https://api.jenzy.com/v2
    description: Production
security: []
paths:
  /deposit-addresses:
    post:
      summary: Get a deposit address
      description: >-
        Your static address for receiving stablecoins on a network. Every call
        for the same network returns the same address, so no `Idempotency-Key`
        is needed. A transfer below 1 USDT or 1 USDC is lost — it is never
        credited and never appears as a collection.
      parameters:
        - $ref: '#/components/parameters/HermesOrg'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                network:
                  type: string
                  enum:
                    - ethereum
                    - solana
                  description: The network to receive on. One static address per network.
                  example: ethereum
              required:
                - network
      responses:
        '200':
          description: Your address on this network.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DepositAddress'
        '400':
          description: '`network` missing or not one of the supported names.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '401':
          description: Missing, malformed, or revoked API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '403':
          description: >-
            Organization suspended, request IP not on the allowlist, or no
            multi-asset access yet (`onboarding_incomplete` /
            `access_suspended`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '422':
          description: >-
            A supported network that has no address for your organization
            (`unsupported_network`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '503':
          description: The `/v2` shutter is closed — check `GET /v2/ping`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      security:
        - ApiKeyAuth: []
components:
  parameters:
    HermesOrg:
      name: HERMES-ORG
      in: header
      required: false
      description: >-
        The id of one of your Child orgs. The call then acts on that Child org,
        not on your organization. If you do not send it, the call acts on your
        organization. An id that is not one of your Child orgs gives `404`.
      schema:
        type: string
        format: uuid
        example: 3f1c2a9e-8b7d-4e21-9a6f-0c5d4b3e2a10
  schemas:
    DepositAddress:
      type: object
      properties:
        network:
          type: string
          description: The network by name, as you requested it (`ethereum`, `solana`).
          example: ethereum
        address:
          type: string
          description: >-
            Your static deposit address on this network. It never changes and
            accepts every asset in `assets`. A transfer below 1 unit of a
            stablecoin is lost: it is never credited and never appears as a
            collection.
          example: '0x52908400098527886E0F7030069857D2E4169EE7'
        assets:
          type: array
          items:
            type: string
            minLength: 1
            description: >-
              An asset code as `GET /v2/assets` lists it — uppercase, never
              compound (`USDC`, `USD`; never `USDC-ETHEREUM`). Network and rail
              live on the payment object.
            example: USDC
          description: >-
            The assets this address accepts. Jenzy credits no other token; to
            recover one, ask Jenzy operations, and expect it to take time.
          example:
            - USDT
            - USDC
      required:
        - network
        - address
        - assets
    ErrorEnvelope:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - validation_error
                - unauthorized
                - forbidden
                - not_found
                - conflict
                - rate_limited
                - internal_error
                - unknown_institution
                - invalid_mobile_number
                - invalid_account_number
                - mobile_number_institution_mismatch
                - service_unavailable
                - sandbox_only
                - insufficient_funds
                - rail_disabled
                - amount_limit_exceeded
                - org_limit_exceeded
                - service_incident
                - service_maintenance
                - onboarding_incomplete
                - access_suspended
                - corridor_not_enabled
                - unsupported_pair
                - invalid_wallet_address
                - rate_unavailable
                - quote_expired
                - quote_used
                - limit_exceeded
                - amount_below_minimum
                - unsupported_asset
                - unsupported_network
                - unsupported_media_type
                - payload_too_large
                - client_ref_used
                - beneficiary_required
                - beneficiary_not_allowed
                - proof_not_expected
                - invalid_beneficiary
                - beneficiary_exists
                - beneficiary_not_active
                - invoice_required
                - prohibited_industry
              description: >-
                Stable identifier a client may branch on — never renamed or
                removed.
            message:
              type: string
          required:
            - code
            - message
      required:
        - error
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      description: 'Your Jenzy API key: `Authorization: Bearer jz_live_…`'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.