--- title: "List transfer quotes" method: GET path: "/quotes" tags: ["Cross-Currency Transfers"] --- # List transfer quotes `GET /quotes` Retrieve a list of transfer quotes with optional filtering parameters. Returns all quotes that match the specified filters. If no filters are provided, returns all quotes (paginated). ## Query parameters - `customerId` string - `sendingAccountId` string - `receivingAccountId` string - `sendingUmaAddress` string - `receivingUmaAddress` string - `status` 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'EXPIRED' - `createdAfter` string, date-time - `createdBefore` string, date-time - `limit` integer - `cursor` string ## Response `200` Successful operation - object - `data` Quote[], required — List of quotes matching the criteria - `quoteId` string, required — Unique identifier for this quote - `status` 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'EXPIRED', required — Current status of the quote - `createdAt` string, date-time, required — When this quote was created - `expiresAt` string, date-time, required — When this quote expires (typically 1-5 minutes after creation) - `source` union, required - AccountQuoteSource — Source account details - `sourceType` 'ACCOUNT', required — Type of quote funding source - `accountId` string, required — Source account identifier - `customerId` string — Required when funding from an FBO account to identify the customer on whose behalf the transaction is being initiated. Otherwise, will default to the customerId of the account owner. - RealtimeFundingQuoteSource — Fund the quote using a real-time funding source (RTP, SEPA Instant, Spark, Stables, etc.). This will require manual just-in-time funding using `paymentInstructions` in the response. Because quotes expire quickly, this option is only valid for instant payment methods. Do not try to fund a quote with a non-instant payment method (ACH, etc.). - `sourceType` 'REALTIME_FUNDING', required — Type of quote funding source - `customerId` string — Source customer ID. If this transaction is being initiated on behalf of a customer, this is required. If customerId is not provided, the quote will be created on behalf of the platform itself. - `currency` string, required — Currency code for the funding source. See [Supported Currencies](https://grid.lightspark.com/platform-overview/core-concepts/currencies-and-rails) for the full list of supported fiat and crypto currencies. - `destination` union, required - AccountDestination — Destination account details - `destinationType` 'ACCOUNT', required — Type of payment destination - `accountId` string, required — Destination account identifier - UmaAddressDestination — UMA address destination details - `destinationType` 'UMA_ADDRESS', required — Type of payment destination - `umaAddress` string, required — UMA address of the recipient - `counterpartyInformation` object — Information about the recipient, as required by the platform in their configuration. - `currency` string — Currency code for the destination. See [Supported Currencies](https://grid.lightspark.com/platform-overview/core-concepts/currencies-and-rails) for the full list of supported fiat and crypto currencies. - ExternalAccountDetailsDestination — A convenient destination option which adds the external account and creates the quote in one step rather than first needing to call /external-accounts to add the account. Useful for one-off payments to some destination. See the external accounts endpoints for test values in sandbox mode. - `destinationType` 'EXTERNAL_ACCOUNT_DETAILS', required — Type of payment destination - `externalAccountDetails` ExternalAccountCreateRequest, required - `customerId` string — The ID of the customer for whom to create the external account. If not provided, the external account will be created on behalf of the platform. - `currency` string, required — The ISO 4217 currency code - `platformAccountId` string — Your platform's identifier for the account in your system. This can be used to reference the account by your own identifier. - `defaultUmaDepositAccount` boolean — Whether to set the external account as the default UMA deposit account. When set to true, incoming payments to this customer's UMA address will be automatically deposited into this external account. False if not provided. Note that only one external account can be set as the default UMA deposit account for a customer, so if there is already a default UMA deposit account, this will override the existing default UMA deposit account. If there is no default UMA deposit account, incoming UMA payments will be deposited into the primary internal account for the customer. - `accountInfo` union, required - UsAccountExternalAccountInfo - … - ClabeAccountExternalAccountInfo - … - PixAccountExternalAccountInfo - … - IbanAccountExternalAccountInfo - … - UpiAccountExternalAccountInfo - … - NgnAccountExternalAccountInfo - … - CadAccountExternalAccountInfo - … - GbpAccountExternalAccountInfo - … - PhpAccountExternalAccountInfo - … - SgdAccountExternalAccountInfo - … - SparkWalletExternalAccountInfo - … - LightningExternalAccountInfo — Lightning payment destination. Exactly one of `invoice`, `bolt12`, or `lightningAddress` must be provided. - … - SolanaWalletExternalAccountInfo - … - TronWalletExternalAccountInfo - … - PolygonWalletExternalAccountInfo - … - BaseWalletExternalAccountInfo - … - `sendingCurrency` Currency, required - `code` string — Three-letter currency code (ISO 4217) for fiat currencies. Some cryptocurrencies may use their own ticker symbols (e.g. "BTC" for Bitcoin, "USDC" for USDC, etc.) - `name` string — Full name of the currency - `symbol` string — Symbol of the currency - `decimals` integer — Number of decimal places for the currency - `receivingCurrency` Currency, required - `code` string — Three-letter currency code (ISO 4217) for fiat currencies. Some cryptocurrencies may use their own ticker symbols (e.g. "BTC" for Bitcoin, "USDC" for USDC, etc.) - `name` string — Full name of the currency - `symbol` string — Symbol of the currency - `decimals` integer — Number of decimal places for the currency - `totalSendingAmount` integer, required — The total amount that will be sent in the smallest unit of the sending currency (eg. cents). - `totalReceivingAmount` integer, required — The total amount that will be received in the smallest unit of the receiving currency (eg. cents). - `exchangeRate` number, required — Number of sending currency units per receiving currency unit. - `feesIncluded` integer, required — The fees associated with the quote in the smallest unit of the sending currency (eg. cents). - `paymentInstructions` PaymentInstructions[] — Payment instructions for executing the payment. This is not required when using an internal account source. - `instructionsNotes` string — Additional human-readable instructions for making the payment - `isPlatformAccount` boolean — Indicates whether the account is a platform account or a customer account. - `accountOrWalletInfo` union, required - PaymentClabeAccountInfo - `accountType` 'CLABE', required — Type of payment account or wallet - `clabeNumber` string, required — 18-digit CLABE number (Mexican banking standard) - `reference` string, required — Unique reference code that must be included with the payment to properly credit it - PaymentUsAccountInfo - `accountType` 'US_ACCOUNT', required — Type of payment account or wallet - `accountNumber` string, required — US bank account number - `routingNumber` string, required — ACH routing number (9 digits) - `accountCategory` 'CHECKING' | 'SAVINGS', required — Type of account (checking or savings) - `bankName` string — Name of the bank - `reference` string, required — Unique reference code that must be included with the payment to properly credit it - PaymentPixAccountInfo - `accountType` 'PIX', required — Type of payment account or wallet - `pixKey` string, required — PIX key for Brazilian instant payments - `pixKeyType` 'CPF' | 'CNPJ' | 'EMAIL' | 'PHONE' | 'RANDOM', required — Type of PIX key being used - `taxId` string, required — Tax ID of the account holder - PaymentIbanAccountInfo - `accountType` 'IBAN', required — Type of payment account or wallet - `iban` string, required — International Bank Account Number - `swiftBic` string, required — SWIFT/BIC code (8 or 11 characters) - `reference` string, required — Unique reference code that must be included with the payment to properly credit it - PaymentUpiAccountInfo - `accountType` 'UPI', required — Type of payment account or wallet - `vpa` string, required — Virtual Payment Address for UPI payments - PaymentSparkWalletInfo - `accountType` 'SPARK_WALLET', required — Type of payment account or wallet - `address` string, required — Spark wallet address - `assetType` 'BTC' | 'USDB', required — Type of asset - `invoice` string — Invoice for the payment - PaymentLightningInvoiceInfo - `accountType` 'CLABE' | 'US_ACCOUNT' | 'PIX' | 'IBAN' | 'UPI' | 'NGN_ACCOUNT' | 'SPARK_WALLET' | 'LIGHTNING' | 'SOLANA_WALLET' | 'TRON_WALLET' | 'POLYGON_WALLET' | 'BASE_WALLET', required — Type of payment account or wallet - `invoice` string, required — Invoice for the payment - PaymentSolanaWalletInfo - `accountType` 'SOLANA_WALLET', required — Type of payment account or wallet - `address` string, required — Solana wallet address - `assetType` 'USDC' | 'USDT' — Type of asset - PaymentTronWalletInfo - `accountType` 'TRON_WALLET', required — Type of payment account or wallet - `address` string, required — Tron wallet address - `assetType` 'USDT' — Type of asset - PaymentPolygonWalletInfo - `accountType` 'POLYGON_WALLET', required — Type of payment account or wallet - `address` string, required — Polygon eth wallet address - `assetType` 'USDC' — Type of asset - PaymentBaseWalletInfo - `accountType` 'BASE_WALLET', required — Type of payment account or wallet - `address` string, required — Base eth wallet address - `assetType` 'USDC' — Type of asset - `transactionId` string, required — The ID of the transaction created from this quote. - `originalQuoteId` string — ID of the quote that is being retried - `rateDetails` OutgoingRateDetails — Details about the rate and fees for an outgoing transaction or quote. - `counterpartyMultiplier` number, double, required — The underlying multiplier from mSATs to the receiving currency as returned by the counterparty institution. - `counterpartyFixedFee` integer, required — The fixed fee charged by the counterparty institution to execute the quote in the smallest unit of the receiving currency (eg. cents). - `gridApiMultiplier` number, double, required — The underlying multiplier from the sending currency to mSATS, including variable fees. - `gridApiFixedFee` integer, required — The fixed fee charged by the Grid product to execute the quote in the smallest unit of the sending currency (eg. cents). - `gridApiVariableFeeRate` number, double, required — The variable fee rate charged by the Grid product to execute the quote as a percentage of the sending currency amount. - `gridApiVariableFeeAmount` number, required — The variable fee amount charged by the Grid product to execute the quote in the smallest unit of the sending currency (eg. cents). This is the sending amount times gridApiVariableFeeRate. - `hasMore` boolean, required — Indicates if more results are available beyond this page - `nextCursor` string — Cursor to retrieve the next page of results (only present if hasMore is true) - `totalCount` integer — Total number of quotes matching the criteria (excluding pagination) ## Other responses - `400` — Bad request - Invalid parameters - `401` — Unauthorized - `500` — Internal service error ## Changes - **2026-02-06** `9d1655bef82d` — 50 breaking, 2 info - the response property `data/items/destination/oneOf[subschema #1: Account]/allOf[subschema #2]/destinationType` became optional for the status `200` - the response property `data/items/destination/oneOf[subschema #2: UMA Address]/allOf[subschema #2]/destinationType` became optional for the status `200` - the response property `data/items/destination/oneOf[subschema #3: External Account Details]/allOf[subschema #2]/destinationType` became optional for the status `200` - the response property `data/items/destination/oneOf[subschema #3: External Account Details]/allOf[subschema #2]/externalAccountDetails/allOf[subschema #1]/accountInfo/oneOf[subschema #10: SGD Account]/allOf[#/components/schemas/SgdAccountInfo]/accountType` became optional for the status `200` - …48 more - **2026-02-05** `42f104b10868` — 62 breaking, 46 warning, 19 info - the `accountType` response property const value `BASE_WALLET` was removed for the status `200` - the `accountType` response property const value `CLABE` was removed for the status `200` - the `accountType` response property const value `IBAN` was removed for the status `200` - the `accountType` response property const value `PIX` was removed for the status `200` - …123 more - …earlier changes not shown [Full history](https://skmtc.dev/lightsparkdev/apis/grid-api/changes/quotes/get.md) --- [API](https://skmtc.dev/lightsparkdev/apis/grid-api.md) · [All operations](https://skmtc.dev/lightsparkdev/apis/grid-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lightsparkdev/grid-api/revisions/9d1655bef82d/schema)