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

# Preview a stablecoin send for a ready customer account

> Preview fees and amounts for a stablecoin send.



## OpenAPI

````yaml /api-reference/openapi.json post /partner/customers/{customer_id}/accounts/{account_id}/sends/preview
openapi: 3.1.0
info:
  title: Element Pay Partner API
  description: >-
    Provider-neutral fiat ↔ crypto ramps for partners. Discover corridors,
    create a binding quote, accept it, and receive webhooks. African local fiat
    (mobile money and bank) is auto-routed by corridor.
  version: 1.0.0
servers:
  - url: https://sandbox.elementpay.net/api/v1
    description: Sandbox
security:
  - APIKeyHeader: []
tags:
  - name: partner
    description: >-
      Corridor discovery, indicative rates, binding quotes, and order acceptance
      (including order-path account currency conversion rails). Customer ledger
      conversions use partner-customer-transfers `/conversions`.
    x-group: Partner
  - name: partner-customers
    description: >-
      Vault KYC: requirements, create, list, get/update, documents, submit, and
      revoke (`pcus_*`).
    x-group: Customers
  - name: partner-customer-accounts
    description: >-
      Customer deposit rails: open / list / get accounts and deposit
      instructions.
    x-group: Customer accounts
  - name: partner-customer-transfers
    description: >-
      On-ledger money movement: stablecoin sends, same-currency book transfers,
      and cross-currency conversions.
    x-group: Customer transfers
  - name: partner-customer-payouts
    description: >-
      External bank payouts: scheme discovery, local bank directory
      (NGN/GHS/CAD), preview, confirm, and status.
    x-group: Customer payouts
paths:
  /partner/customers/{customer_id}/accounts/{account_id}/sends/preview:
    post:
      tags:
        - partner-customer-transfers
      summary: Preview a stablecoin send for a ready customer account
      description: Preview fees and amounts for a stablecoin send.
      operationId: >-
        partner_customer_preview_send_partner_customers__customer_id__accounts__account_id__sends_preview_post
      parameters:
        - name: customer_id
          in: path
          required: true
          schema:
            type: string
            description: Public customer id returned by POST /partner/customers
            examples:
              - pcus_a1b2c3d4e5f6
            title: Customer Id
            example: pcus_a1b2c3d4e5f6
          description: Public customer id returned by POST /partner/customers
          example: pcus_a1b2c3d4e5f6
        - name: account_id
          in: path
          required: true
          schema:
            type: integer
            minimum: 1
            description: Account id returned by the customer account API
            title: Account Id
            example: 21
          description: Account id returned by the customer account API
          example: 21
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PartnerEntitySendPreviewRequest'
            example:
              to_address: '0x40C2f2e0326bD1f647fbeB8732529e08B4DB309f'
              amount: '5.00'
              network: Base
              memo: optional-stellar-memo
      responses:
        '201':
          description: Estimated fees and preview token for confirm step.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerSuccessEnvelope'
              example:
                status: success
                message: Send preview
                data:
                  preview_token: nvsend.eyJhbGciOiJIUzI1NiJ9.preview
                  currency: USDC
                  network: Base
                  amount: '5.00'
                  fee: '0.05'
                  receive_amount: '4.95'
                  fee_status: estimated
                  chain_disclaimer: Send only USDC on Base to the destination address.
                  expires_at: '2026-07-30T12:10:00+00:00'
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - message
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                  data:
                    type:
                      - object
                      - 'null'
              example:
                status: error
                message: Unauthorized
                data: null
        '409':
          description: Deposit account is not ready
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - message
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                  data:
                    type:
                      - object
                      - 'null'
              example:
                status: error
                message: Deposit account is not ready
                data:
                  deposit_account_status: pending
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - message
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                  data:
                    type:
                      - object
                      - 'null'
              example:
                status: error
                message: Validation error
                data:
                  field: country
      security:
        - APIKeyHeader: []
components:
  schemas:
    PartnerEntitySendPreviewRequest:
      properties:
        to_address:
          type: string
          maxLength: 128
          minLength: 8
          title: To Address
        amount:
          type: string
          title: Amount
          description: Decimal amount in USDC, e.g. 10.50
        network:
          anyOf:
            - type: string
            - type: 'null'
          title: Network
          description: Must match the account network when set (Base or Polygon)
      type: object
      required:
        - to_address
        - amount
      title: PartnerEntitySendPreviewRequest
      description: Preview a same-asset USDC send (fee + receive amount; not an FX quote).
      example:
        amount: '5.00'
        network: Base
        to_address: 0xRecipientWalletAddress
    PartnerSuccessEnvelope:
      type: object
      required:
        - status
        - message
        - data
      properties:
        status:
          type: string
          enum:
            - success
        message:
          type: string
        data:
          type: object
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key

````