---
title: "Get a pooled bank payin quote"
method: POST
path: "/api/v1/banks/payin/quote"
tags: ["Banks", "banks"]
---

# Get a pooled bank payin quote

`POST /api/v1/banks/payin/quote`

Create a Swipelux quote for paying into the user's custodial wallet via a pooled bank rail.

## Headers

- `x-api-key` string, nullable

## Request body

- BankPayinQuoteRequest — Request a Swipelux payin quote for a pooled bank rail.
  - `amount` union, required
    - number
    - string
  - `bankAccountId` string, uuid, required
  - `memo` string, nullable

## Response `200`

Successful Response

- BankPayinQuoteResponse — Swipelux payin quote response normalized for bank payins.
  - `quoteId` string, required
  - `provider` 'swipelux' | 'align' | 'mcp' | 'wirex' — Supported fiat payment providers.
  - `bankAccountId` string, uuid, required
  - `rail` 'uaefts_named-zand' | 'ach_pooled-hsbc' | 'ach_named-citi' | 'ach_named-jpmorgan_chase' | 'ach_named-cfsb' | 'fedwire_pooled-hsbc' | 'fedwire_pooled-jpmorgan_chase' | 'fedwire_pooled-cfsb' | 'fedwire_named-hsbc' | 'fedwire_named-citi' | 'fedwire_named-jpmorgan_chase' | 'fedwire_named-cfsb' | 'sepa_pooled-zen' | 'sepa_named-zen' | 'swift_pooled-hsbc' | 'swift_named-hsbc', required — Bank account route: provider rail + bank id (`{rail}-{bank}`).
  - `paymentRail` string, required
  - `fromAmount` string, required
  - `fromCurrency` string, required
  - `toAmount` string, required
  - `toCurrency` string
  - `feeAmount` string, nullable
  - `feeCurrency` string, nullable
  - `rate` string, nullable
  - `expiresAt` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/hevn-inc/apis/hevn-api.md) · [All operations](https://skmtc.net/hevn-inc/apis/hevn-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hevn-inc/hevn-api/versions/e6301d6796bf/schema)