Lightspark Same-Currency Transfers API is one of 22 APIs that Lightspark publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Same-Currency Transfers. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.
This API exposes
2 operations
across 2 paths,
and defines 175 schemas.
It is described by OpenAPI 3.1.0, at version 2025-10-13.
Requests are made against a single base URL, https://api.lightspark.com/grid/2025-10-13.
The identity and technical contract details declared by the specification.
Lightspark Same-Currency Transfers API declares
3 security schemes
for authenticating requests.
It accepts HTTP basic authentication (BasicAuth).
It accepts HTTP bearer tokens (AgentAuth).
An API key is passed in the header as X-Grid-Signature (WebhookSignature).
By default, every request must be authenticated.
BasicAuth — API token authentication using format :AgentAuth — Bearer token authentication for agent-scoped endpoints. The token is the accessToken returned when redeeming a device code via POST /agents/device-codes/{code}…WebhookSignature — Secp256r1 (P-256) asymmetric signature of the webhook payload, which can be used to verify that the webhook was sent by Grid. To verify the signature: 1. Get t…
Same-Currency Transfers 2
Endpoints for transferring funds between internal and external accounts with the same currency
POST
/transfer-in
Create a transfer-in request
createTransferIn
1 param
body
→ 201400401404500
POST
/transfer-out
Create a transfer-out request
createTransferOut
1 param
body
→ 201400401404500
PaymentEmbeddedWalletInfo
EurAccountInfoBase
object
3 properties
2 required
TransactionStatus
string
Status of a payment transaction. | Status | Description | |--------|-------------| | CREATED | Initial lookup has been created | | PENDING | Quote has been cre…
Error404
object
4 properties
3 required
BaseTransactionDestination
object
2 properties
1 required
GtqAccountInfoBase
object
4 properties
4 required
CadAccountInfoBase
object
4 properties
4 required
BaseWalletInfo
object
2 properties
2 required
GbpAccountInfoBase
object
3 properties
3 required
PaymentRail
string
The payment rail used for the transfer. Payment rails represent the underlying payment network or system used to move funds between accounts.
OutgoingRateDetails
object
Details about the rate and fees for an outgoing transaction or quote. Note: counterpartyFixedFee is denominated in the receiving currency, so its equivalent va…
6 properties
6 required
OutgoingTransactionStatus
string
Status of an outgoing payment transaction. | Status | Description | |--------|-------------| | PENDING | Quote is pending confirmation | | PENDINGAUTHORIZATION…
CardPullSummary
object
3 properties
2 required
CurrencyAmount
object
2 properties
2 required
MyrAccountInfoBase
object
4 properties
4 required
OutgoingTransactionFailureReason
string
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, t…
Error400
object
4 properties
3 required
HtgAccountInfoBase
object
2 properties
2 required
IdrAccountInfoBase
object
5 properties
5 required
Error500
object
4 properties
3 required
HkdAccountInfoBase
object
4 properties
4 required
SwiftAccountInfoBase
object
6 properties
4 required
PaymentInstructions
object
3 properties
1 required
BasePaymentAccountInfo
object
1 property
1 required
IncomingTransactionFailureReason
string
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, t…
ExternalAccountDestinationReference
object
2 properties
1 required
KesAccountInfoBase
object
3 properties
3 required
ExternalAccountReference
object
1 property
1 required
UgxAccountInfoBase
object
3 properties
3 required
TransactionType
string
Type of transaction (incoming payment or outgoing payment)
MxnAccountInfoBase
object
2 properties
2 required
InrAccountInfoBase
object
Required fields depend on the selected paymentRails: - NEFT: accountNumber, ifsc, rail - RTGS: accountNumber, ifsc, rail - UPI: vpa
6 properties
1 required
TransferOutRequest
object
4 properties
2 required
PolygonWalletInfo
object
2 properties
2 required
TransactionDirection
string
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…
TransactionDestinationOneOf
MwkAccountInfoBase
object
3 properties
3 required
Error401
object
4 properties
3 required
RealtimeFundingTransactionSource
SolanaWalletInfo
object
2 properties
2 required
RwfAccountInfoBase
object
3 properties
3 required
SlvAccountInfoBase
object
Required fields depend on the selected paymentRails: - BANKTRANSFER: bankAccountType, accountNumber - MOBILEMONEY: phoneNumber
5 properties
1 required
PhpAccountInfoBase
object
3 properties
3 required
GhsAccountInfoBase
object
Required fields depend on the selected paymentRails: - BANKTRANSFER: accountNumber, bankName - MOBILEMONEY: bankName, phoneNumber
4 properties
2 required
AedAccountInfoBase
object
3 properties
2 required
ReconciliationInstructions
object
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 s…
2 properties
EthereumWalletInfo
object
2 properties
2 required
CardTransaction
object
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 pul…
20 properties
12 required
TronWalletInfo
object
2 properties
2 required
CardSettlementSummary
object
2 properties
2 required
PaymentAccountType
string
Type of payment account or wallet
CardRefundSummary
object
2 properties
2 required
CardTransactionStatus
string
Lifecycle status of a card transaction. | Status | Description | |--------|-------------| | AUTHORIZED | The auth has been approved and a hold placed on the fu…
CnyAccountInfoBase
object
Required fields depend on the selected paymentRails: - BANKTRANSFER: accountNumber, bankName - MOBILEMONEY: bankName, phoneNumber
4 properties
2 required
CounterpartyInformation
object
Additional information about the counterparty, if available and relevant to the transaction and platform.
UmaAddressTransactionSource
AccountTransactionDestination
OnChainTransaction
object
2 properties
2 required
CryptoNetwork
string
The blockchain network an on-chain transaction settled on. Whether this is the mainnet or a test network (e.g. Solana devnet) is determined by your platform's…
TransactionSourceType
string
Type of transaction source
JmdAccountInfoBase
object
5 properties
5 required
TransactionDestinationType
string
Type of transaction destination
Transaction
object
14 properties
7 required
RailSelectionMode
string
How the payment rail was chosen — MANUAL when the platform specified a paymentRail on the destination, AUTO when Lightspark selects it.
NgnAccountInfoBase
object
3 properties
3 required
PaymentLightningInvoiceInfo
TzsAccountInfoBase
object
3 properties
3 required
ThbAccountInfoBase
object
4 properties
4 required
XafAccountInfoBase
object
4 properties
4 required
PaymentEthereumWalletInfo
BdtAccountInfoBase
object
Required fields depend on the selected paymentRails: - BANKTRANSFER: accountNumber, bankName - MOBILEMONEY: bankName, phoneNumber
6 properties
2 required
UsdAccountInfoBase
object
3 properties
3 required
XofAccountInfoBase
object
4 properties
4 required
InternalAccountReference
object
1 property
1 required
PkrAccountInfoBase
object
Required fields depend on the selected paymentRails: - BANKTRANSFER: accountNumber, bankName - MOBILEMONEY: bankName, phoneNumber
5 properties
2 required
EgpAccountInfoBase
object
Required fields depend on the selected paymentRails: - BANKTRANSFER: bankName, iban - MOBILEMONEY: bankName, phoneNumber
4 properties
2 required
SparkWalletInfo
object
2 properties
2 required
DkkAccountInfoBase
object
3 properties
2 required
ZmwAccountInfoBase
object
3 properties
3 required
VndAccountInfoBase
object
4 properties
4 required
BaseTransactionSource
object
2 properties
1 required
IncomingRateDetails
object
Details about the rate and fees for an incoming transaction. Note: gridApiFixedFee is denominated in the receiving currency, so its equivalent value in the sen…
4 properties
4 required
UmaAddressTransactionDestination
Currency
object
4 properties
BwpAccountInfoBase
object
3 properties
3 required
Refund
object
5 properties
3 required
TransferInRequest
object
3 properties
2 required
ZarAccountInfoBase
object
3 properties
3 required
SgdAccountInfoBase
object
4 properties
3 required
CardMerchant
object
3 properties
1 required
The full machine-readable OpenAPI contract behind this narrative.
Other APIs Lightspark publishes across the network.
