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

# List Payouts

> Retrieve all payouts for your merchant account with pagination

<Note>
  **Auth method: Signed (HMAC)** — this endpoint requires the full set of signed
  headers: `x-access-id`, `x-request-id`, `x-timestamp`, and an HMAC-SHA256
  `authorization` signature. See [Authentication](/api-reference/authentication#signed-hmac-authentication).
</Note>

## Headers

<ParamField header="x-access-id" type="string" required>
  Your API access ID provided by Tender

  **Example:** `"your-access-id-here"`
</ParamField>

## Query Parameters

<ParamField query="page" type="number">
  Page number for pagination

  **Example:** `1`
</ParamField>

<ParamField query="limit" type="number">
  Number of records per page

  **Example:** `10`
</ParamField>

## Response

<ResponseField name="status" type="string" required>
  **Example:** `"success"`
</ResponseField>

<ResponseField name="message" type="string" required>
  **Example:** `"success"`
</ResponseField>

<ResponseField name="data" type="object" required>
  Paginated payout records

  <Expandable title="data properties">
    <ResponseField name="data" type="array">
      Array of payout objects

      <Expandable title="payout object">
        <ResponseField name="_id" type="string">
          **Example:** `"66aec7de809b7f45c42a49f9"`
        </ResponseField>

        <ResponseField name="merchantId" type="string">
          **Example:** `"6538e8f9bdec6d1a21978a64"`
        </ResponseField>

        <ResponseField name="type" type="string">
          `crypto` or `fiat`

          **Example:** `"crypto"`
        </ResponseField>

        <ResponseField name="status" type="string">
          **Example:** `"completed"`
        </ResponseField>

        <ResponseField name="amount" type="string">
          **Example:** `"50"`
        </ResponseField>

        <ResponseField name="coin" type="string">
          **Example:** `"usdt"`
        </ResponseField>

        <ResponseField name="chain" type="string">
          **Example:** `"tron"`
        </ResponseField>

        <ResponseField name="address" type="string">
          Destination wallet address (crypto payouts)

          **Example:** `"TQn9Y2khDD9JHTfVE5oB2h8BKWWM4LxKLT"`
        </ResponseField>

        <ResponseField name="fee" type="string">
          **Example:** `"0.5"`
        </ResponseField>

        <ResponseField name="txHash" type="string">
          On-chain transaction hash (after broadcast)

          **Example:** `"0xabc123..."`
        </ResponseField>

        <ResponseField name="createdAt" type="string">
          **Example:** `"2024-09-24T22:20:15.650Z"`
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="pages" type="number">
      **Example:** `2`
    </ResponseField>

    <ResponseField name="page" type="number">
      **Example:** `1`
    </ResponseField>

    <ResponseField name="limit" type="number">
      **Example:** `10`
    </ResponseField>
  </Expandable>
</ResponseField>


## OpenAPI

````yaml GET /v1/api/payout
openapi: 3.1.0
info:
  title: Tender API
  description: Tender Developer API for cryptocurrency payments and agent management
  version: 1.0.0
  contact:
    name: Tender Support
    url: https://tender.cash
servers:
  - url: https://secureapi.tender.cash
    description: Production Server
  - url: https://sandbox-api.tender.cash
    description: Sandbox Server
security:
  - SignedAuth: []
tags:
  - name: Agents
    description: Manage agents and sub-businesses
  - name: Transactions
    description: Payment and transaction operations
  - name: System
    description: System information and configuration
  - name: Webhooks
    description: Webhook management and logs
  - name: On-ramp
    description: Fiat-to-crypto on-ramp operations
  - name: Payouts
    description: Send crypto from merchant balance to a wallet address or payout account
  - name: Subwallets
    description: Provision and manage crypto wallet infrastructure for your end-users
paths:
  /v1/api/payout:
    get:
      tags:
        - Payouts
      summary: List Payouts
      description: Retrieve all payouts for your merchant account with pagination.
      operationId: listPayouts
      parameters:
        - name: authorization
          in: header
          required: true
          schema:
            type: string
        - name: x-timestamp
          in: header
          required: true
          schema:
            type: string
            format: date-time
          example: '2025-03-15T09:45:53.000Z'
        - name: x-request-id
          in: header
          required: true
          schema:
            type: string
            format: uuid
          example: 550e8400-e29b-41d4-a716-446655440000
        - name: x-access-id
          in: header
          required: true
          schema:
            type: string
          example: your-access-id-here
        - name: page
          in: query
          required: false
          schema:
            type: integer
          example: 1
        - name: limit
          in: query
          required: false
          schema:
            type: integer
          example: 10
      responses:
        '200':
          description: Paginated list of payouts
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListPayoutsResponse'
              example:
                status: success
                message: success
                data:
                  data:
                    - _id: 66aec7de809b7f45c42a49f9
                      type: crypto
                      status: completed
                      amount: '50'
                      coin: usdt
                      chain: tron
                      address: TQn9Y2khDD9JHTfVE5oB2h8BKWWM4LxKLT
                      fee: '0.5'
                      txHash: 0xabc123def456...
                      createdAt: '2024-09-24T22:20:15.650Z'
                  pages: 1
                  page: 1
                  limit: 10
      security:
        - SignedAuth: []
components:
  schemas:
    ListPayoutsResponse:
      type: object
      properties:
        status:
          type: string
        message:
          type: string
        data:
          type: object
          properties:
            data:
              type: array
              items:
                $ref: '#/components/schemas/PayoutRecord'
            pages:
              type: integer
            page:
              type: integer
            limit:
              type: integer
    PayoutRecord:
      type: object
      properties:
        status:
          type: string
        message:
          type: string
        data:
          type: object
          properties:
            _id:
              type: string
            merchantId:
              type: string
            type:
              type: string
              enum:
                - crypto
                - fiat
            status:
              type: string
              enum:
                - pending
                - processing
                - completed
                - failed
            amount:
              type: string
            coin:
              type: string
            chain:
              type: string
            address:
              type: string
            fee:
              type: string
            feeUSD:
              type: string
            txHash:
              type: string
            createdAt:
              type: string
              format: date-time
            updatedAt:
              type: string
              format: date-time
  securitySchemes:
    SignedAuth:
      type: apiKey
      in: header
      name: authorization
      description: >-
        Signed (HMAC) authentication. Required headers: x-access-id,
        x-request-id (UUID v4), x-timestamp (ISO 8601), and authorization
        (Base64 HMAC-SHA256 signature of {timeStamp, requestId, accessId} using
        your access secret).

````