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

# List Onramp Transfers

> Retrieve all onramp (fiat-to-crypto) transfers for a customer

## Method Signature

```typescript theme={null}
align.transfers.listOnrampTransfers(
  customerId: string
): Promise<TransferListResponse>
```

## Parameters

<ParamField path="customerId" type="string" required>
  The unique customer identifier (UUID format)
</ParamField>

## Returns

<ResponseField name="items" type="Transfer[]">
  Array of onramp transfer objects
</ResponseField>

## Examples

<Tabs>
  <Tab title="TypeScript">
    ```typescript theme={null}
    import Align from "@tolbel/align";

    const align = new Align({
      apiKey: process.env.ALIGN_API_KEY!,
      environment: "sandbox",
    });

    const response = await align.transfers.listOnrampTransfers(
      "123e4567-e89b-12d3-a456-426614174000"
    );

    console.log(`Total onramp transfers: ${response.items.length}`);

    for (const transfer of response.items) {
      console.log(`${transfer.id}: ${transfer.status}`);
      console.log(`  $${transfer.source_amount} USD → ${transfer.destination_amount} USDC`);
    }
    ```
  </Tab>

  <Tab title="JavaScript">
    ```javascript theme={null}
    const response = await align.transfers.listOnrampTransfers(
      "123e4567-e89b-12d3-a456-426614174000"
    );

    response.items.forEach((transfer) => {
      console.log(`${transfer.id}: ${transfer.status}`);
    });
    ```
  </Tab>
</Tabs>

### Filter by Status

```typescript theme={null}
const response = await align.transfers.listOnrampTransfers(customerId);

// Get only completed onramps
const completed = response.items.filter((t) => t.status === "completed");

// Calculate total fiat spent
const totalSpent = completed.reduce(
  (sum, t) => sum + parseFloat(t.source_amount),
  0
);

console.log(`Total fiat spent: $${totalSpent} USD`);
```

## Related Methods

<CardGroup cols={2}>
  <Card title="List Offramp Transfers" icon="list" href="/docs/api/transfers/list-offramp-transfers">
    List crypto-to-fiat transfers
  </Card>

  <Card title="Get Onramp Transfer" icon="arrow-up" href="/docs/api/transfers/get-onramp-transfer">
    Get specific onramp
  </Card>
</CardGroup>