Skip to content

Add source/destination type discriminators in examples #193

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
shreyav merged 1 commit into from
Feb 13, 2026
Merged

Add source/destination type discriminators in examples #193

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions mintlify/global-p2p/quickstart.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -143,12 +143,13 @@ In this guide, the entities map as follows:
-H "Content-Type: application/json" \
-d '{
"source": {
"sourceType": "REALTIME_FUNDING",
"customerId": "Customer:019542f5-b3e7-1d02-0000-000000000001",
"currency": "USDC"
},
"destination": {
"accountId": "ExternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123",
"currency": "MXN"
"destinationType": "ACCOUNT",
"accountId": "ExternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123"
},
"lockedCurrencySide": "SENDING",
"lockedCurrencyAmount": 10000,
Expand Down
7 changes: 6 additions & 1 deletion mintlify/openapi.yaml
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

5 changes: 3 additions & 2 deletions mintlify/payouts-and-b2b/payment-flow/send-payment.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -185,11 +185,12 @@ curl -X POST 'https://api.lightspark.com/grid/2025-10-13/quotes' \
-H 'Content-Type: application/json' \
-d '{
"source": {
"sourceType": "ACCOUNT",
"accountId": "InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965"
},
"destination": {
"accountId": "ExternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123",
"currency": "EUR"
"destinationType": "ACCOUNT",
"accountId": "ExternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123"
},
"lockedCurrencySide": "SENDING",
"lockedCurrencyAmount": 10000,
Expand Down
2 changes: 2 additions & 0 deletions mintlify/payouts-and-b2b/platform-tools/sandbox-testing.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -156,9 +156,11 @@ POST /quotes

{
"source": {
"sourceType": "ACCOUNT",
"accountId": "InternalAccount:abc123"
},
"destination": {
"destinationType": "EXTERNAL_ACCOUNT_DETAILS",
"externalAccountDetails": {
"customerId": "Customer:123",
"currency": "EUR",
Expand Down
5 changes: 3 additions & 2 deletions mintlify/payouts-and-b2b/quickstart.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -273,11 +273,12 @@ curl -X POST "https://api.lightspark.com/grid/2025-10-13/quotes" \
-d '{
"lookupId": "LookupRequest:019542f5-b3e7-1d02-0000-000000000009", # ID from the lookup step
"source": {
"sourceType": "ACCOUNT",
"accountId": "InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965" # USD internal account
},
"destination": {
"accountId": "ExternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123",
"currency": "MXN"
"destinationType": "ACCOUNT",
"accountId": "ExternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123"
},
"lockedCurrencySide": "SENDING",
"lockedCurrencyAmount": 50000,
Expand Down
4 changes: 2 additions & 2 deletions mintlify/platform-overview/core-concepts/account-model.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -205,8 +205,8 @@ You'll receive `ACCOUNT_STATUS` webhooks as status changes.
POST /quotes

{
"source": {"accountId": "InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965"},
"destination": {"accountId": "ExternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123"},
"source": {"sourceType": "ACCOUNT", "accountId": "InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965"},
"destination": {"destinationType": "ACCOUNT", "accountId": "ExternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123"},
"lockedCurrencySide": "SENDING",
"lockedCurrencyAmount": 100000
}
Expand Down
4 changes: 2 additions & 2 deletions mintlify/platform-overview/core-concepts/currencies-and-rails.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,8 +34,8 @@ Grid handles currency conversion automatically through the quote system:
POST /quotes

{
"source": {"accountId": "InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965"},
"destination": {"accountId": "ExternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123", "currency": "MXN"},
"source": {"sourceType": "ACCOUNT", "accountId": "InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965"},
"destination": {"destinationType": "ACCOUNT", "accountId": "ExternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123"},
"lockedCurrencySide": "SENDING",
"lockedCurrencyAmount": 100000
}
Expand Down
14 changes: 10 additions & 4 deletions mintlify/platform-overview/core-concepts/quote-system.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -54,10 +54,11 @@ curl -X POST https://api.lightspark.com/grid/2025-10-13/quotes \
-H "Content-Type: application/json" \
-d '{
"source": {
"sourceType": "ACCOUNT",
"accountId": "InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965"
},
"destination": {
"currency": "BTC",
"destinationType": "ACCOUNT",
"accountId": "ExternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123"
},
"lockedCurrencySide": "SENDING",
Expand Down Expand Up @@ -146,6 +147,7 @@ Source is an existing internal account with available balance:
```json
{
"source": {
"sourceType": "ACCOUNT",
"accountId": "InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965"
}
}
Expand All @@ -162,7 +164,9 @@ Source is the customer ID or the platform itself — Grid provides payment instr
```json
{
"source": {
"customerId": "Customer:019542f5-b3e7-1d02-0000-000000000001"
"sourceType": "REALTIME_FUNDING",
"customerId": "Customer:019542f5-b3e7-1d02-0000-000000000001",
"currency": "USD"
}
}
```
Expand Down Expand Up @@ -247,8 +251,8 @@ curl -X POST https://api.lightspark.com/grid/2025-10-13/quotes \
-u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \
-H "Content-Type: application/json" \
-d '{
"source": {"accountId": "InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965"},
"destination": {"accountId": "ExternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123", "currency": "EUR"},
"source": {"sourceType": "ACCOUNT", "accountId": "InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965"},
"destination": {"destinationType": "ACCOUNT", "accountId": "ExternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123"},
"lockedCurrencySide": "SENDING",
"lockedCurrencyAmount": 100000,
"immediatelyExecute": true
Expand Down Expand Up @@ -305,9 +309,11 @@ You can create an external account inline when creating a quote:
```json
{
"source": {
"sourceType": "ACCOUNT",
"accountId": "InternalAccount:abc123"
},
"destination": {
"destinationType": "EXTERNAL_ACCOUNT_DETAILS",
"externalAccountDetails": {
"customerId": "Customer:019542f5-b3e7-1d02-0000-000000000001",
"currency": "EUR",
Expand Down
4 changes: 2 additions & 2 deletions mintlify/platform-overview/core-concepts/transaction-lifecycle.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,8 +49,8 @@ Once a transaction reaches a terminal status, it will not change further.
POST /quotes

{
"source": {"accountId": "InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965"},s
"destination": {"accountId": "ExternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123", "currency": "EUR"},
"source": {"sourceType": "ACCOUNT", "accountId": "InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965"},
"destination": {"destinationType": "ACCOUNT", "accountId": "ExternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123"},
"lockedCurrencySide": "SENDING",
"lockedCurrencyAmount": 100000
}
Expand Down
12 changes: 6 additions & 6 deletions mintlify/rewards/developer-guides/distributing-rewards.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -292,8 +292,8 @@ curl -X GET "https://api.lightspark.com/grid/2025-10-13/transactions/{transactio

```json
{
"source": { "accountId": "InternalAccount:..." },
"destination": { "externalAccountDetails": { ... } },
"source": { "sourceType": "ACCOUNT", "accountId": "InternalAccount:..." },
"destination": { "destinationType": "EXTERNAL_ACCOUNT_DETAILS", "externalAccountDetails": { ... } },
"lockedCurrencySide": "SENDING",
"lockedCurrencyAmount": 100,
"immediatelyExecute": true
Expand All @@ -304,8 +304,8 @@ curl -X GET "https://api.lightspark.com/grid/2025-10-13/transactions/{transactio

```json
{
"source": { "accountId": "InternalAccount:..." },
"destination": { "accountId": "ExternalAccount:..." },
"source": { "sourceType": "ACCOUNT", "accountId": "InternalAccount:..." },
"destination": { "destinationType": "ACCOUNT", "accountId": "ExternalAccount:..." },
"lockedCurrencySide": "RECEIVING",
"lockedCurrencyAmount": 1000,
"immediatelyExecute": true
Expand All @@ -316,8 +316,8 @@ curl -X GET "https://api.lightspark.com/grid/2025-10-13/transactions/{transactio

```json
{
"source": { "accountId": "InternalAccount:..." },
"destination": { "accountId": "ExternalAccount:..." },
"source": { "sourceType": "ACCOUNT", "accountId": "InternalAccount:..." },
"destination": { "destinationType": "ACCOUNT", "accountId": "ExternalAccount:..." },
"lockedCurrencySide": "SENDING",
"lockedCurrencyAmount": 5000,
"immediatelyExecute": false
Expand Down
9 changes: 6 additions & 3 deletions mintlify/rewards/platform-tools/sandbox-testing.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -250,8 +250,9 @@ curl -X POST "https://api.lightspark.com/grid/2025-10-13/quotes" \
-u "sandbox_token_id:sandbox_token_secret" \
-H "Content-Type: application/json" \
-d '{
"source": {"accountId": "InternalAccount:platform-usd"},
"source": {"sourceType": "ACCOUNT", "accountId": "InternalAccount:platform-usd"},
"destination": {
"destinationType": "EXTERNAL_ACCOUNT_DETAILS",
"externalAccountDetails": {
"customerId": "Customer:test001",
"currency": "BTC",
Expand All @@ -272,8 +273,9 @@ curl -X POST "https://api.lightspark.com/grid/2025-10-13/quotes" \
-u "sandbox_token_id:sandbox_token_secret" \
-H "Content-Type: application/json" \
-d '{
"source": {"accountId": "InternalAccount:platform-usd"},
"source": {"sourceType": "ACCOUNT", "accountId": "InternalAccount:platform-usd"},
"destination": {
"destinationType": "EXTERNAL_ACCOUNT_DETAILS",
"externalAccountDetails": {
"customerId": "Customer:test001",
"currency": "BTC",
Expand All @@ -294,8 +296,9 @@ curl -X POST "https://api.lightspark.com/grid/2025-10-13/quotes" \
-u "sandbox_token_id:sandbox_token_secret" \
-H "Content-Type: application/json" \
-d '{
"source": {"accountId": "InternalAccount:platform-usd"},
"source": {"sourceType": "ACCOUNT", "accountId": "InternalAccount:platform-usd"},
"destination": {
"destinationType": "EXTERNAL_ACCOUNT_DETAILS",
"externalAccountDetails": {
"customerId": "Customer:test001",
"currency": "BTC",
Expand Down
13 changes: 7 additions & 6 deletions mintlify/snippets/sending/cross-currency.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,8 @@ curl -X POST 'https://api.lightspark.com/grid/2025-10-13/quotes' \
-u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \
-H 'Content-Type: application/json' \
-d '{
"source": { "accountId": "InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965" },
"destination": { "accountId": "ExternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123", "currency": "EUR" },
"source": { "sourceType": "ACCOUNT", "accountId": "InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965" },
"destination": { "destinationType": "ACCOUNT", "accountId": "ExternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123" },
"lockedCurrencySide": "SENDING",
"lockedCurrencyAmount": 10000,
"description": "Payment for services - Invoice #1234"
Expand Down Expand Up @@ -54,8 +54,8 @@ curl -X POST 'https://api.lightspark.com/grid/2025-10-13/quotes' \

```json
{
"source": { "accountId": "InternalAccount:..." },
"destination": { "accountId": "ExternalAccount:...", "currency": "EUR" },
"source": { "sourceType": "ACCOUNT", "accountId": "InternalAccount:..." },
"destination": { "destinationType": "ACCOUNT", "accountId": "ExternalAccount:..." },
"lockedCurrencySide": "SENDING",
"lockedCurrencyAmount": 10000,
"senderCustomerInfo": {
Expand Down Expand Up @@ -173,11 +173,12 @@ curl -X POST 'https://api.lightspark.com/grid/2025-10-13/quotes' \
-u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \
-H 'Content-Type: application/json' \
-d '{
"source": {
"source": {
"sourceType": "REALTIME_FUNDING",
"customerId": "Customer:019542f5-b3e7-1d02-0000-000000000001",
"currency": "USDC"
},
"destination": { "accountId": "ExternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123", "currency": "EUR" },
"destination": { "destinationType": "ACCOUNT", "accountId": "ExternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123" },
"lockedCurrencySide": "SENDING",
"lockedCurrencyAmount": 10000,
"description": "Payment for services - Invoice #1234"
Expand Down
2 changes: 1 addition & 1 deletion mintlify/snippets/sending/uma.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ curl -X POST "https://api.lightspark.com/grid/2025-10-13/quotes" \
-H "Content-Type: application/json" \
-d '{
"lookupId": "Lookup:019542f5-b3e7-1d02-0000-000000000009",
"source": { "accountId": "InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965" },
"source": { "sourceType": "ACCOUNT", "accountId": "InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965" },
"sendingCurrencyCode": "USD",
"receivingCurrencyCode": "EUR",
"lockedCurrencySide": "SENDING",
Expand Down
7 changes: 6 additions & 1 deletion openapi.yaml
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

7 changes: 6 additions & 1 deletion openapi/paths/quotes/quotes.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,10 +42,11 @@ post:
summary: Account to Account Transfer
value:
source:
sourceType: ACCOUNT
accountId: InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965
destination:
destinationType: ACCOUNT
accountId: ExternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123
currency: EUR
lockedCurrencySide: SENDING
lockedCurrencyAmount: 10000
description: 'Transfer between accounts, either internal or external.'
Expand All @@ -54,8 +55,10 @@ post:
value:
lookupId: LookupRequest:019542f5-b3e7-1d02-0000-000000000009
source:
sourceType: ACCOUNT
accountId: InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965
destination:
destinationType: UMA_ADDRESS
umaAddress: $receiver@uma.domain.com
currency: EUR
lockedCurrencySide: SENDING
Expand All @@ -65,9 +68,11 @@ post:
summary: Real-time funding to Spark Wallet as an on-ramp flow. Immediate execution.
value:
source:
sourceType: REALTIME_FUNDING
customerId: Customer:019542f5-b3e7-1d02-0000-000000000009
currency: USD
destination:
destinationType: EXTERNAL_ACCOUNT_DETAILS
externalAccountDetails:
customerId: Customer:019542f5-b3e7-1d02-0000-000000000001
currency: BTC
Expand Down