> ## 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 Conversions

> Retrieve all conversions for your merchant account with optional filters and 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>

<ParamField query="status" type="string">
  Filter by conversion status. Passing `pending` returns both `pending` and `processing` records.

  **Allowed values:** `pending`, `processing`, `completed`

  **Example:** `"completed"`
</ParamField>

## Response

<ResponseField name="status" type="string" required>
  Status of the API request

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

<ResponseField name="message" type="string" required>
  Human-readable message describing the result

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

<ResponseField name="data" type="object" required>
  Conversions list and aggregate history

  <Expandable title="data properties">
    <ResponseField name="conversion" type="object">
      Paginated list of conversion records

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

          <Expandable title="conversion object">
            <ResponseField name="_id" type="string">
              Unique identifier for the conversion

              **Example:** `"66aec7de809b7f45c42a49f9"`
            </ResponseField>

            <ResponseField name="merchantId" type="string">
              Merchant associated with the conversion

              **Example:** `"6538e8f9bdec6d1a21978a64"`
            </ResponseField>

            <ResponseField name="type" type="string">
              Conversion type: `crypto` (swap) or `fiat` (payout account)

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

            <ResponseField name="status" type="string">
              Current status of the conversion

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

            <ResponseField name="amount" type="string">
              Source amount

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

            <ResponseField name="coin" type="string">
              Source coin identifier

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

            <ResponseField name="chain" type="string">
              Source chain identifier

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

            <ResponseField name="toChain" type="string">
              Destination chain (crypto swaps only)

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

            <ResponseField name="toCoin" type="string">
              Destination coin (crypto swaps only)

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

            <ResponseField name="processingStages" type="object">
              Lifecycle stages of the conversion

              <Expandable title="processingStages properties">
                <ResponseField name="sendForConversion" type="object">
                  **Example:** `{ "status": "completed" }`
                </ResponseField>

                <ResponseField name="conversionState" type="object">
                  **Example:** `{ "status": "completed" }`
                </ResponseField>

                <ResponseField name="settleCrypto" type="object">
                  **Example:** `{ "status": "completed" }`
                </ResponseField>

                <ResponseField name="settleFiat" type="object">
                  Present only for fiat conversions.

                  **Example:** `{ "status": "completed" }`
                </ResponseField>
              </Expandable>
            </ResponseField>

            <ResponseField name="createdAt" type="string">
              ISO 8601 timestamp

              **Example:** `"2024-09-24T22:20:15.650Z"`
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="pages" type="number">
          Total number of pages

          **Example:** `3`
        </ResponseField>

        <ResponseField name="page" type="number">
          Current page

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

        <ResponseField name="limit" type="number">
          Items per page

          **Example:** `10`
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="history" type="object">
      Aggregate totals for all conversion statuses

      **Example:** `{ "total": 25, "completed": 20, "pending": 5 }`
    </ResponseField>
  </Expandable>
</ResponseField>