--- title: "List transactions" method: GET path: "/transactions" tags: ["Transactions"] --- # List transactions `GET /transactions` Retrieve a paginated list of transactions with optional filtering. The transactions can be filtered by customer ID, platform customer ID, UMA address, date range, status, and transaction type. Card transactions are included and identified by `type: CARD`. In Sandbox this is how you discover a `CardTransaction` id after simulating an authorization — list the transactions, take the card transaction's `id`, and pass it as the `cardTransactionId` to the clearing and return simulate endpoints. ## Query parameters - `customerId` string - `platformCustomerId` string - `accountIdentifier` string - `senderAccountIdentifier` string - `receiverAccountIdentifier` string - `status` 'CREATED' | 'PENDING' | 'PENDING_AUTHORIZATION' | 'PROCESSING' | 'COMPLETED' | 'REJECTED' | 'FAILED' | 'REFUNDED' | 'EXPIRED' — Status of a payment transaction. | Status | Description | |--------|-------------| | `CREATED` | Initial lookup has been created | | `PENDING` | Quote has been created | | `PENDING_AUTHORIZATION` | Awaiting Strong Customer Authentication. Only occurs for customers in a region where SCA is required (e.g. EU); authorize the transaction's `scaChallenge` to proceed. | | `PROCESSING` | Funding has been received and payment initiated | | `COMPLETED` | Cross border payment has been received, converted and payment has been sent to the offramp network | | `REJECTED` | Receiving institution or wallet rejected payment, payment has been refunded | | `FAILED` | An error occurred during payment | | `REFUNDED` | Payment was unable to complete and refunded | | `EXPIRED` | Quote has expired | - `type` 'INCOMING' | 'OUTGOING' — Type of transaction (incoming payment or outgoing payment) - `reference` string - `startDate` string, date-time - `endDate` string, date-time - `limit` integer - `cursor` string - `sortOrder` 'asc' | 'desc' ## Response `200` Successful operation - TransactionListResponse - `data` TransactionOneOf[], required — List of transactions matching the criteria - union - IncomingTransaction - `id` string, required — Unique identifier for the transaction - `status` 'CREATED' | 'PENDING' | 'PENDING_AUTHORIZATION' | 'PROCESSING' | 'COMPLETED' | 'REJECTED' | 'FAILED' | 'REFUNDED' | 'EXPIRED', required — Status of a payment transaction. | Status | Description | |--------|-------------| | `CREATED` | Initial lookup has been created | | `PENDING` | Quote has been created | | `PENDING_AUTHORIZATION` | Awaiting Strong Customer Authentication. Only occurs for customers in a region where SCA is required (e.g. EU); authorize the transaction's `scaChallenge` to proceed. | | `PROCESSING` | Funding has been received and payment initiated | | `COMPLETED` | Cross border payment has been received, converted and payment has been sent to the offramp network | | `REJECTED` | Receiving institution or wallet rejected payment, payment has been refunded | | `FAILED` | An error occurred during payment | | `REFUNDED` | Payment was unable to complete and refunded | | `EXPIRED` | Quote has expired | - `type` 'INCOMING', required — Type of transaction (incoming payment or outgoing payment) - `direction` 'CREDIT' | 'DEBIT', required — Whether the transaction credits (funds in) or debits (funds out) the customer's account. Independent of `type`: an incoming transaction is normally a `CREDIT`, but an inbound ACH pull, for example, is an `INCOMING` transaction with a `DEBIT` direction. - `destination` union, required - AccountTransactionDestination — Destination account details - `destinationType` 'ACCOUNT', required — Type of transaction destination - `currency` string — Currency code for the destination - `accountId` string, required — Destination account identifier - `onChainTransaction` OnChainTransaction - … - UmaAddressTransactionDestination — UMA address destination details - `destinationType` 'UMA_ADDRESS', required — Type of transaction destination - `currency` string — Currency code for the destination - `umaAddress` string, required — UMA address of the recipient - `customerId` string, required — System ID of the customer this transaction belongs to - `platformCustomerId` string, required — Platform-specific ID of the customer this transaction belongs to - `settledAt` string, date-time — When the payment was or will be settled - `createdAt` string, date-time — When the transaction was created - `updatedAt` string, date-time — When the transaction was last updated - `receiptDeliveryConfirmedAt` string, date-time — The time at which the platform confirmed delivery of the receipt to their customer. - `agentId` string — If this transaction was initiated by an agent, the system-generated ID of that agent. Absent for platform-initiated transactions. - `description` string — Optional memo or description for the payment - `sentAmount` CurrencyAmount - `amount` integer, required — Amount in the smallest unit of the currency (e.g., cents for USD/EUR, satoshis for BTC) - `currency` 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 - `exchangeRate` number — Number of sending currency units per receiving currency unit. - `quoteId` string — The ID of the quote that was used to trigger this payment - `refund` Refund - `reference` string, required — The unique reference ID of the refund - `initiatedAt` string, date-time, required — When the refund was initiated - `settledAt` string, date-time — When the refund was settled - `status` 'PENDING' | 'COMPLETED' | 'FAILED', required — Current status of the refund - `reason` 'TRANSACTION_FAILED' | 'USER_CANCELLATION' | 'TIMEOUT' — Reason for the refund - `counterpartyInformation` CounterpartyInformation — Additional information about the counterparty, if available and relevant to the transaction and platform. - `source` union - AccountTransactionSource — Source account details - `sourceType` 'ACCOUNT', required — Type of transaction source - `currency` string — Currency code for the source - `accountId` string, required — Source account identifier - `onChainTransaction` OnChainTransaction - … - UmaAddressTransactionSource — UMA address source details - `sourceType` 'UMA_ADDRESS', required — Type of transaction source - `currency` string — Currency code for the source - `umaAddress` string, required — UMA address of the sender - RealtimeFundingTransactionSource — Transaction was funded using an external funding source. All originator fields are optional and populated on a best-effort basis depending on what the funding source provides. - `sourceType` 'REALTIME_FUNDING', required — Type of transaction source - `currency` string, required — Currency code for the funding source - `customerId` string — The customer on whose behalf the transaction was initiated. - `accountHolderName` string — The name of the originator (sender) of the payment. - `accountIdentifier` string — The originator's account number or IBAN. May be masked or partial depending on the rail. - `bankName` string — The name of the originating bank. - `bankIdentifier` string — The identifier of the originating bank, such as a routing number, BIC, or SWIFT code. - `paymentRail` 'ACH' | 'ACH_COLOMBIA' | 'BANK_TRANSFER' | 'BRE_B' | 'CIPS' | 'FAST' | 'FASTER_PAYMENTS' | 'FEDNOW' | 'INSTAPAY' | 'MOBILE_MONEY' | 'NEFT' | 'PAYNOW' | 'PESONET' | 'PIX' | 'RTGS' | 'RTP' | 'SEPA' | 'SEPA_INSTANT' | 'SPEI' | 'SWIFT' | 'UNIONPAY' | 'UPI' | 'WIRE' — The payment rail used for the transfer. Payment rails represent the underlying payment network or system used to move funds between accounts. - `remittanceInformation` string — Free-form information about the payment provided by the originator. The source field depends on the payment rail: the Addenda record for ACH, the OBI / beneficiary information for wires, and the remittanceInformation field for RTP and FedNow. - `endToEndId` string — The originator's own end-to-end reference for the payment. - `traceNumber` string — Rail-level tracking identifier for the payment, such as an ACH trace number or a wire IMAD/OMAD, useful for reconciliation. - `onChainTransaction` OnChainTransaction - … - `receivedAmount` CurrencyAmount, required - `amount` integer, required — Amount in the smallest unit of the currency (e.g., cents for USD/EUR, satoshis for BTC) - `currency` 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 - `fees` integer — The total fees available from the receive quote in the smallest unit of the sending currency (eg. cents). - `reconciliationInstructions` ReconciliationInstructions — Instructions for reconciling a payment with this transaction. For the on-chain transaction to or from an external crypto wallet that is the transaction's own source or destination, use the `onChainTransaction` on the relevant source or destination instead. - `reference` string — Unique reference code to include with the payment to match it with the correct incoming transaction, when available. - `transactionHash` string — Transaction hash of the internal settlement transfer used to deliver a UMA payment — the inter-VASP settlement leg (e.g. USDC on Solana to the receiving partner), when available. This is not a transfer to a customer's own wallet; for that, see the `onChainTransaction` on the transaction's source or destination. - `failureReason` 'LNURLP_FAILED' | 'PAY_REQUEST_FAILED' | 'PAYMENT_APPROVAL_WEBHOOK_ERROR' | 'PAYMENT_APPROVAL_TIMED_OUT' | 'OFFRAMP_FAILED' | 'MISSING_MANDATORY_PAYEE_DATA' | 'QUOTE_EXPIRED' | 'QUOTE_EXECUTION_FAILED' — Reason for failure of an incoming transaction. This is used to provide more context on why a transaction failed. If the transaction is not in a failed state, this field is omitted. - OutgoingTransaction - `id` string, required — Unique identifier for the transaction - `status` 'PENDING' | 'PENDING_AUTHORIZATION' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'EXPIRED', required — Status of an outgoing payment transaction. | Status | Description | |--------|-------------| | `PENDING` | Quote is pending confirmation | | `PENDING_AUTHORIZATION` | Awaiting Strong Customer Authentication. Only occurs for customers in a region where SCA is required (e.g. EU); authorize the transaction's `scaChallenge` to proceed. | | `EXPIRED` | Quote wasn't executed before expiry window | | `PROCESSING` | Executing the quote after receiving funds | | `COMPLETED` | Payout successfully reached the destination | | `FAILED` | Something went wrong — accompanied by a `failureReason` | - `type` 'OUTGOING', required — Type of transaction (incoming payment or outgoing payment) - `direction` 'CREDIT' | 'DEBIT', required — Whether the transaction credits (funds in) or debits (funds out) the customer's account. Independent of `type`: an incoming transaction is normally a `CREDIT`, but an inbound ACH pull, for example, is an `INCOMING` transaction with a `DEBIT` direction. - `destination` union, required - AccountTransactionDestination — Destination account details - `destinationType` 'ACCOUNT', required — Type of transaction destination - `currency` string — Currency code for the destination - `accountId` string, required — Destination account identifier - `onChainTransaction` OnChainTransaction - … - UmaAddressTransactionDestination — UMA address destination details - `destinationType` 'UMA_ADDRESS', required — Type of transaction destination - `currency` string — Currency code for the destination - `umaAddress` string, required — UMA address of the recipient - `customerId` string, required — System ID of the customer this transaction belongs to - `platformCustomerId` string, required — Platform-specific ID of the customer this transaction belongs to - `settledAt` string, date-time — When the payment was or will be settled - `createdAt` string, date-time — When the transaction was created - `updatedAt` string, date-time — When the transaction was last updated - `receiptDeliveryConfirmedAt` string, date-time — The time at which the platform confirmed delivery of the receipt to their customer. - `agentId` string — If this transaction was initiated by an agent, the system-generated ID of that agent. Absent for platform-initiated transactions. - `description` string — Optional memo or description for the payment - `sentAmount` CurrencyAmount, required - `amount` integer, required — Amount in the smallest unit of the currency (e.g., cents for USD/EUR, satoshis for BTC) - `currency` 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 - `exchangeRate` number — Number of sending currency units per receiving currency unit. - `quoteId` string — The ID of the quote that was used to trigger this payment - `refund` Refund - `reference` string, required — The unique reference ID of the refund - `initiatedAt` string, date-time, required — When the refund was initiated - `settledAt` string, date-time — When the refund was settled - `status` 'PENDING' | 'COMPLETED' | 'FAILED', required — Current status of the refund - `reason` 'TRANSACTION_FAILED' | 'USER_CANCELLATION' | 'TIMEOUT' — Reason for the refund - `counterpartyInformation` CounterpartyInformation — Additional information about the counterparty, if available and relevant to the transaction and platform. - `source` union, required - AccountTransactionSource — Source account details - `sourceType` 'ACCOUNT', required — Type of transaction source - `currency` string — Currency code for the source - `accountId` string, required — Source account identifier - `onChainTransaction` OnChainTransaction - … - UmaAddressTransactionSource — UMA address source details - `sourceType` 'UMA_ADDRESS', required — Type of transaction source - `currency` string — Currency code for the source - `umaAddress` string, required — UMA address of the sender - RealtimeFundingTransactionSource — Transaction was funded using an external funding source. All originator fields are optional and populated on a best-effort basis depending on what the funding source provides. - `sourceType` 'REALTIME_FUNDING', required — Type of transaction source - `currency` string, required — Currency code for the funding source - `customerId` string — The customer on whose behalf the transaction was initiated. - `accountHolderName` string — The name of the originator (sender) of the payment. - `accountIdentifier` string — The originator's account number or IBAN. May be masked or partial depending on the rail. - `bankName` string — The name of the originating bank. - `bankIdentifier` string — The identifier of the originating bank, such as a routing number, BIC, or SWIFT code. - `paymentRail` 'ACH' | 'ACH_COLOMBIA' | 'BANK_TRANSFER' | 'BRE_B' | 'CIPS' | 'FAST' | 'FASTER_PAYMENTS' | 'FEDNOW' | 'INSTAPAY' | 'MOBILE_MONEY' | 'NEFT' | 'PAYNOW' | 'PESONET' | 'PIX' | 'RTGS' | 'RTP' | 'SEPA' | 'SEPA_INSTANT' | 'SPEI' | 'SWIFT' | 'UNIONPAY' | 'UPI' | 'WIRE' — The payment rail used for the transfer. Payment rails represent the underlying payment network or system used to move funds between accounts. - `remittanceInformation` string — Free-form information about the payment provided by the originator. The source field depends on the payment rail: the Addenda record for ACH, the OBI / beneficiary information for wires, and the remittanceInformation field for RTP and FedNow. - `endToEndId` string — The originator's own end-to-end reference for the payment. - `traceNumber` string — Rail-level tracking identifier for the payment, such as an ACH trace number or a wire IMAD/OMAD, useful for reconciliation. - `onChainTransaction` OnChainTransaction - … - `receivedAmount` CurrencyAmount - `amount` integer, required — Amount in the smallest unit of the currency (e.g., cents for USD/EUR, satoshis for BTC) - `currency` 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 - `fees` integer — The fees associated with the quote in the smallest unit of the sending currency (eg. cents). - `platformFees` integer — The portion of `fees` collected by the platform (platform-configured transaction fees), in the smallest unit of the sending currency. 0 when the platform has no applicable fee configured. Already included in `fees`. - `reconciliationInstructions` ReconciliationInstructions — Instructions for reconciling a payment with this transaction. For the on-chain transaction to or from an external crypto wallet that is the transaction's own source or destination, use the `onChainTransaction` on the relevant source or destination instead. - `reference` string — Unique reference code to include with the payment to match it with the correct incoming transaction, when available. - `transactionHash` string — Transaction hash of the internal settlement transfer used to deliver a UMA payment — the inter-VASP settlement leg (e.g. USDC on Solana to the receiving partner), when available. This is not a transfer to a customer's own wallet; for that, see the `onChainTransaction` on the transaction's source or destination. - `paymentInstructions` PaymentInstructions[] — Payment instructions for executing the payment. — unresolved $ref - `rateDetails` OutgoingRateDetails — Details about the rate and fees for an outgoing transaction or quote. Note: `counterpartyFixedFee` is denominated in the receiving currency, so its equivalent value in the sending currency fluctuates with the FX rate. As a result, the total fee on a subsequent quote for the same transfer may differ even if the underlying fee structure is unchanged. - `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. - `failureReason` 'QUOTE_EXPIRED' | 'QUOTE_EXECUTION_FAILED' | 'LIGHTNING_PAYMENT_FAILED' | 'FUNDING_AMOUNT_MISMATCH' | 'COUNTERPARTY_POST_TX_FAILED' | 'SCA_NOT_COMPLETED' | 'EXECUTION_FAILED_POST_DEBIT' | 'SETTLEMENT_FAILED' | 'TIMEOUT' | 'MANUAL_REFUND' — Reason for failure of an outgoing transaction. This is used to provide more context on why a transaction failed. If the transaction is not in a failed state, this field is omitted. `SCA_NOT_COMPLETED` means the customer did not satisfy the Strong Customer Authentication challenge before it expired, so the transaction was never authorized and no funds were moved. Only occurs for customers in a region where SCA is required (e.g. the EU). Create a new quote to try again, and have the customer authorize it while the challenge is live. - `paymentRail` 'ACH' | 'ACH_COLOMBIA' | 'BANK_TRANSFER' | 'BRE_B' | 'CIPS' | 'FAST' | 'FASTER_PAYMENTS' | 'FEDNOW' | 'INSTAPAY' | 'MOBILE_MONEY' | 'NEFT' | 'PAYNOW' | 'PESONET' | 'PIX' | 'RTGS' | 'RTP' | 'SEPA' | 'SEPA_INSTANT' | 'SPEI' | 'SWIFT' | 'UNIONPAY' | 'UPI' | 'WIRE' — The payment rail used for the transfer. Payment rails represent the underlying payment network or system used to move funds between accounts. - `railSelectionMode` 'AUTO' | 'MANUAL' — How the payment rail was chosen — MANUAL when the platform specified a paymentRail on the destination, AUTO when Lightspark selects it. - `expectedSettlementAt` string, date-time, nullable — Expected settlement time at the beneficiary. Null for instant rails (settlement is immediate) and before a rail with deferred settlement is resolved. - `settlementTimelineSeconds` integer, nullable — Expected number of seconds from quote creation to settlement. Null when not yet known. - CardTransaction — Parent transaction row for a card authorization and all of the pulls / settlements / refunds that reconcile against it. Child events are rolled up into the `pullSummary`, `refundSummary`, and `settlementSummary` aggregates. Delivered as the payload of the generic transaction webhook stream (extends the Transaction model with a card destination type) on every transition. - `type` 'CARD', required — Discriminator identifying this transaction as a card transaction in the `Transaction` list. - `id` string, required — System-generated unique card transaction identifier - `cardId` string — The id of the `Card` this transaction was made on. - `customerId` string, required — System ID of the customer (cardholder) this transaction belongs to. - `platformCustomerId` string, required — Platform-specific ID of the customer (cardholder) this transaction belongs to. - `issuerTransactionToken` string — Opaque identifier for the transaction on the underlying issuer. Used to cross-reference Grid records against issuer dashboards and webhooks. - `status` 'AUTHORIZED' | 'PARTIALLY_SETTLED' | 'SETTLED' | 'REFUNDED' | 'EXCEPTION', required — Lifecycle status of a card transaction. | Status | Description | |--------|-------------| | `AUTHORIZED` | The auth has been approved and a hold placed on the funding source; no clearing has arrived yet. | | `PARTIALLY_SETTLED` | At least one clearing has arrived and posted, but more clearings are still expected (split shipments, tips, multi-leg trips). | | `SETTLED` | All clearings for the auth have posted and the transaction is closed against the funding source. | | `REFUNDED` | A `RETURN` was received from the merchant; the net settled amount has been refunded in part or whole. | | `EXCEPTION` | The transaction settled to the card network but the corresponding pull from the funding source failed (e.g. balance no longer covers the post-hoc clearing). Surfaces high-urgency alerts and is the dashboard query for stuck reconciliations. | - `direction` 'CREDIT' | 'DEBIT', required — Whether the transaction credits (funds in) or debits (funds out) the customer's account. Independent of `type`: an incoming transaction is normally a `CREDIT`, but an inbound ACH pull, for example, is an `INCOMING` transaction with a `DEBIT` direction. - `merchant` CardMerchant, required - `descriptor` string, required — Merchant descriptor string captured from the card network at authorization time. - `mcc` string — Merchant Category Code (ISO 18245) — four-digit numeric string. - `country` string — Two-letter ISO 3166-1 alpha-2 country code of the merchant. - `authorizedAmount` CurrencyAmount, required - `amount` integer, required — Amount in the smallest unit of the currency (e.g., cents for USD/EUR, satoshis for BTC) - `currency` 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 - `settledAmount` CurrencyAmount - `amount` integer, required — Amount in the smallest unit of the currency (e.g., cents for USD/EUR, satoshis for BTC) - `currency` 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 - `refundedAmount` CurrencyAmount - `amount` integer, required — Amount in the smallest unit of the currency (e.g., cents for USD/EUR, satoshis for BTC) - `currency` 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 - `accountId` string, required — Internal account id that funded this transaction (the funding source selected by Authorization Decisioning at auth time). - `pullSummary` CardPullSummary - `count` integer, required — Total number of pulls (debits) executed against the funding source for this transaction. `> 1` indicates one or more post-hoc pulls — e.g. restaurant tip / over-auth clearings. - `totalAmount` integer, required — Sum of all pull amounts in the smallest unit of the funding source's currency. - `pendingCount` integer — Number of pulls still in the `PENDING` state. Drops to zero when every pull has reached a terminal state. Non-zero values that persist beyond the expected settlement window are an early signal for the `EXCEPTION` path. - `refundSummary` CardRefundSummary - `count` integer, required — Number of refund (return) events received for this transaction. - `totalAmount` integer, required — Sum of all refund amounts in the smallest unit of the funding source's currency. - `settlementSummary` CardSettlementSummary - `count` integer, required — Number of settlement (clearing) events received for this transaction. - `totalAmount` integer, required — Sum of all settled amounts in the smallest unit of the funding source's currency. - `authorizedAt` string, date-time, required — When the auth was approved. - `lastEventAt` string, date-time — Timestamp of the most recent reconcile event (pull / clearing / refund) against this transaction. - `createdAt` string, date-time, required — Creation timestamp (same as `authorizedAt` for card transactions). - `updatedAt` string, date-time, required — Last update timestamp. - `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 transactions matching the criteria (excluding pagination) ## Other responses - `400` — Bad request - Invalid parameters - `401` — Unauthorized - `500` — Internal service error --- [API](https://skmtc.net/stainless-api/apis/grid-api.md) · [All operations](https://skmtc.net/stainless-api/apis/grid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stainless-api/grid-api/revisions/df12ec487f0e/schema)