Lightspark · Schema
InternalAccount
CompanyPaymentsCross-Border PaymentsStablecoinsBitcoinLightning NetworkEmbedded FinanceAgentic PaymentsCardsKYCFinancial ServicesForeign Exchange
Properties
| Name | Type | Description |
|---|---|---|
| id | string | The ID of the internal account |
| customerId | string | The ID of the customer associated with the internal account. If this field is empty, the internal account belongs to the platform. |
| type | object | |
| status | object | |
| balance | object | The balance available to spend, excluding pending and held funds |
| totalBalance | object | The total balance, including pending and held funds |
| fundingPaymentInstructions | array | Payment instructions for funding the account |
| privateEnabled | boolean | Whether wallet privacy is enabled for the Embedded Wallet. Only present for `EMBEDDED_WALLET` internal accounts. |
| createdAt | string | Timestamp when the internal account was created |
| updatedAt | string | Timestamp when the internal account was last updated |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/lightspark/main/json-schema/lightspark-internal-account-schema.json",
"title": "InternalAccount",
"x-generated": "2026-10-12",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/lightspark-internal-accounts-api-openapi.yml#/components/schemas/InternalAccount",
"type": "object",
"required": [
"id",
"type",
"status",
"balance",
"totalBalance",
"fundingPaymentInstructions",
"createdAt",
"updatedAt"
],
"properties": {
"id": {
"type": "string",
"description": "The ID of the internal account"
},
"customerId": {
"type": "string",
"description": "The ID of the customer associated with the internal account. If this field is empty, the internal account belongs to the platform."
},
"type": {
"$ref": "#/$defs/InternalAccountType"
},
"status": {
"$ref": "#/$defs/InternalAccountStatus"
},
"balance": {
"$ref": "#/$defs/CurrencyAmount",
"description": "The balance available to spend, excluding pending and held funds"
},
"totalBalance": {
"$ref": "#/$defs/CurrencyAmount",
"description": "The total balance, including pending and held funds"
},
"fundingPaymentInstructions": {
"type": "array",
"description": "Payment instructions for funding the account",
"items": {
"$ref": "#/$defs/PaymentInstructions"
}
},
"privateEnabled": {
"type": "boolean",
"description": "Whether wallet privacy is enabled for the Embedded Wallet. Only present for `EMBEDDED_WALLET` internal accounts."
},
"createdAt": {
"type": "string",
"format": "date-time",
"description": "Timestamp when the internal account was created"
},
"updatedAt": {
"type": "string",
"format": "date-time",
"description": "Timestamp when the internal account was last updated"
}
},
"$defs": {
"AedAccountInfo": {
"allOf": [
{
"$ref": "#/$defs/AedAccountInfoBase"
},
{
"type": "object",
"required": [
"paymentRails"
],
"properties": {
"paymentRails": {
"type": "array",
"items": {
"type": "string",
"enum": [
"BANK_TRANSFER"
]
}
}
}
}
]
},
"AedAccountInfoBase": {
"type": "object",
"required": [
"accountType",
"iban"
],
"properties": {
"accountType": {
"type": "string",
"enum": [
"AED_ACCOUNT"
]
},
"iban": {
"type": "string",
"description": "UAE IBAN (23 characters, starting with AE)",
"minLength": 23,
"maxLength": 23,
"pattern": "^AE[0-9]{21}$"
},
"swiftCode": {
"type": "string",
"description": "The SWIFT/BIC code of the bank",
"minLength": 8,
"maxLength": 11,
"pattern": "^[A-Z]{4}[A-Z]{2}[A-Z0-9]{2}([A-Z0-9]{3})?$"
}
}
},
"BasePaymentAccountInfo": {
"type": "object",
"required": [
"accountType"
],
"properties": {
"accountType": {
"$ref": "#/$defs/PaymentAccountType"
}
}
},
"BaseWalletInfo": {
"type": "object",
"required": [
"address",
"accountType"
],
"properties": {
"accountType": {
"type": "string",
"enum": [
"BASE_WALLET"
]
},
"address": {
"type": "string",
"description": "Base eth wallet address"
}
}
},
"BdtAccountInfo": {
"allOf": [
{
"$ref": "#/$defs/BdtAccountInfoBase"
},
{
"type": "object",
"required": [
"paymentRails"
],
"properties": {
"paymentRails": {
"type": "array",
"items": {
"type": "string",
"enum": [
"BANK_TRANSFER",
"MOBILE_MONEY"
]
}
}
}
}
]
},
"BdtAccountInfoBase": {
"type": "object",
"required": [
"accountType",
"bankName"
],
"description": "Required fields depend on the selected paymentRails:\n- BANK_TRANSFER: accountNumber, bankName\n- MOBILE_MONEY: bankName, phoneNumber",
"properties": {
"accountType": {
"type": "string",
"enum": [
"BDT_ACCOUNT"
]
},
"accountNumber": {
"type": "string",
"description": "The account number of the bank",
"minLength": 1,
"maxLength": 34
},
"bankName": {
"type": "string",
"description": "The name of the bank",
"minLength": 1,
"maxLength": 255
},
"branchCode": {
"type": "string",
"description": "The branch code",
"minLength": 5,
"maxLength": 5,
"pattern": "^[0-9]{5}$"
},
"swiftCode": {
"type": "string",
"description": "The SWIFT/BIC code of the bank",
"minLength": 8,
"maxLength": 11,
"pattern": "^[A-Z]{4}[A-Z]{2}[A-Z0-9]{2}([A-Z0-9]{3})?$"
},
"phoneNumber": {
"type": "string",
"description": "The phone number in international format",
"minLength": 7,
"maxLength": 15,
"pattern": "^\\+[0-9]{6,14}$"
}
}
},
"BwpAccountInfo": {
"allOf": [
{
"$ref": "#/$defs/BwpAccountInfoBase"
},
{
"type": "object",
"required": [
"paymentRails"
],
"properties": {
"paymentRails": {
"type": "array",
"items": {
"type": "string",
"enum": [
"MOBILE_MONEY"
]
}
}
}
}
]
},
"BwpAccountInfoBase": {
"type": "object",
"required": [
"accountType",
"phoneNumber",
"provider"
],
"properties": {
"accountType": {
"type": "string",
"enum": [
"BWP_ACCOUNT"
]
},
"phoneNumber": {
"type": "string",
"description": "The phone number in international format",
"minLength": 7,
"maxLength": 15,
"pattern": "^\\+[0-9]{6,14}$"
},
"provider": {
"type": "string",
"description": "The mobile money provider name",
"minLength": 1,
"maxLength": 255
}
}
},
"CadAccountInfo": {
"allOf": [
{
"$ref": "#/$defs/CadAccountInfoBase"
},
{
"type": "object",
"required": [
"paymentRails"
],
"properties": {
"paymentRails": {
"type": "array",
"items": {
"type": "string",
"enum": [
"BANK_TRANSFER"
]
}
}
}
}
]
},
"CadAccountInfoBase": {
"type": "object",
"required": [
"accountType",
"bankCode",
"branchCode",
"accountNumber"
],
"properties": {
"accountType": {
"type": "string",
"enum": [
"CAD_ACCOUNT"
]
},
"bankCode": {
"type": "string",
"description": "Canadian financial institution number (3 digits)",
"minLength": 3,
"maxLength": 3,
"pattern": "^[0-9]{3}$"
},
"branchCode": {
"type": "string",
"description": "Transit number identifying the branch (5 digits)",
"minLength": 5,
"maxLength": 5,
"pattern": "^[0-9]{5}$"
},
"accountNumber": {
"type": "string",
"description": "Bank account number (7-12 digits)",
"minLength": 7,
"maxLength": 12,
"pattern": "^[0-9]{7,12}$"
}
}
},
"CnyAccountInfo": {
"allOf": [
{
"$ref": "#/$defs/CnyAccountInfoBase"
},
{
"type": "object",
"required": [
"paymentRails"
],
"properties": {
"paymentRails": {
"type": "array",
"items": {
"type": "string",
"enum": [
"BANK_TRANSFER",
"MOBILE_MONEY"
]
}
}
}
}
]
},
"CnyAccountInfoBase": {
"type": "object",
"required": [
"accountType",
"bankName"
],
"description": "Required fields depend on the selected paymentRails:\n- BANK_TRANSFER: accountNumber, bankName\n- MOBILE_MONEY: bankName, phoneNumber",
"properties": {
"accountType": {
"type": "string",
"enum": [
"CNY_ACCOUNT"
]
},
"accountNumber": {
"type": "string",
"description": "The account number of the bank",
"minLength": 1,
"maxLength": 34
},
"bankName": {
"type": "string",
"description": "The name of the bank",
"minLength": 1,
"maxLength": 255
},
"phoneNumber": {
"type": "string",
"description": "The phone number in international format",
"minLength": 7,
"maxLength": 15,
"pattern": "^\\+[0-9]{6,14}$"
}
}
},
"Currency": {
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "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": {
"type": "string",
"description": "Full name of the currency"
},
"symbol": {
"type": "string",
"description": "Symbol of the currency"
},
"decimals": {
"type": "integer",
"description": "Number of decimal places for the currency",
"minimum": 0
}
}
},
"CurrencyAmount": {
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "integer",
"format": "int64",
"description": "Amount in the smallest unit of the currency (e.g., cents for USD/EUR, satoshis for BTC)"
},
"currency": {
"$ref": "#/$defs/Currency"
}
}
},
"DkkAccountInfo": {
"allOf": [
{
"$ref": "#/$defs/DkkAccountInfoBase"
},
{
"type": "object",
"required": [
"paymentRails"
],
"properties": {
"paymentRails": {
"type": "array",
"items": {
"type": "string",
"enum": [
"SEPA",
"SEPA_INSTANT"
]
}
}
}
}
]
},
"DkkAccountInfoBase": {
"type": "object",
"required": [
"accountType",
"iban"
],
"properties": {
"accountType": {
"type": "string",
"enum": [
"DKK_ACCOUNT"
]
},
"iban": {
"type": "string",
"description": "Danish IBAN (18 characters, starting with DK)",
"minLength": 18,
"maxLength": 18,
"pattern": "^DK[0-9]{16}$"
},
"swiftCode": {
"type": "string",
"description": "The SWIFT/BIC code of the bank",
"minLength": 8,
"maxLength": 11,
"pattern": "^[A-Z]{4}[A-Z]{2}[A-Z0-9]{2}([A-Z0-9]{3})?$"
}
}
},
"EgpAccountInfo": {
"allOf": [
{
"$ref": "#/$defs/EgpAccountInfoBase"
},
{
"type": "object",
"required": [
"paymentRails"
],
"properties": {
"paymentRails": {
"type": "array",
"items": {
"type": "string",
"enum": [
"BANK_TRANSFER",
"MOBILE_MONEY"
]
}
}
}
}
]
},
"EgpAccountInfoBase": {
"type": "object",
"required": [
"accountType",
"bankName"
],
"description": "Required fields depend on the selected paymentRails:\n- BANK_TRANSFER: bankName, iban\n- MOBILE_MONEY: bankName, phoneNumber",
"properties": {
"accountType": {
"type": "string",
"enum": [
"EGP_ACCOUNT"
]
},
"iban": {
"type": "string",
"description": "Egyptian IBAN (29 characters, starting with EG)",
"minLength": 29,
"maxLength": 29,
"pattern": "^EG[0-9]{27}$"
},
"bankName": {
"type": "string",
"description": "The name of the bank",
"minLength": 1,
"maxLength": 255
},
"phoneNumber": {
"type": "string",
"description": "The phone number in international format",
"minLength": 7,
"maxLength": 15,
"pattern": "^\\+[0-9]{6,14}$"
}
}
},
"EthereumWalletInfo": {
"type": "object",
"required": [
"address",
"accountType"
],
"properties": {
"accountType": {
"type": "string",
"enum": [
"ETHEREUM_WALLET"
]
},
"address": {
"type": "string",
"description": "Ethereum L1 wallet address"
}
}
},
"EurAccountInfo": {
"allOf": [
{
"$ref": "#/$defs/EurAccountInfoBase"
},
{
"type": "object",
"required": [
"paymentRails"
],
"properties": {
"paymentRails": {
"type": "array",
"items": {
"type": "string",
"enum": [
"SEPA",
"SEPA_INSTANT"
]
}
}
}
}
]
},
"EurAccountInfoBase": {
"type": "object",
"required": [
"accountType",
"iban"
],
"properties": {
"accountType": {
"type": "string",
"enum": [
"EUR_ACCOUNT"
]
},
"iban": {
"type": "string",
"description": "The IBAN of the bank account",
"minLength": 15,
"maxLength": 34,
"pattern": "^[A-Z]{2}[0-9]{2}[A-Za-z0-9]{11,30}$"
},
"swiftCode": {
"type": "string",
"description": "The SWIFT/BIC code of the bank",
"minLength": 8,
"maxLength": 11,
"pattern": "^[A-Z]{4}[A-Z]{2}[A-Z0-9]{2}([A-Z0-9]{3})?$"
}
}
},
"GbpAccountInfo": {
"allOf": [
{
"$ref": "#/$defs/GbpAccountInfoBase"
},
{
"type": "object",
"required": [
"paymentRails"
],
"properties": {
"paymentRails": {
"type": "array",
"items": {
"type": "string",
"enum": [
"FASTER_PAYMENTS"
]
}
}
}
}
]
},
"GbpAccountInfoBase": {
"type": "object",
"required": [
"accountType",
"sortCode",
"accountNumber"
],
"properties": {
"accountType": {
"type": "string",
"enum": [
"GBP_ACCOUNT"
]
},
"sortCode": {
"type": "string",
"description": "The UK sort code",
"minLength": 6,
"maxLength": 6,
"pattern": "^[0-9]{6}$"
},
"accountNumber": {
"type": "string",
"description": "UK bank account number (8 digits)",
"minLength": 8,
"maxLength": 8,
"pattern": "^[0-9]{8}$"
}
}
},
"GhsAccountInfo": {
"allOf": [
{
"$ref": "#/$defs/GhsAccountInfoBase"
},
{
"type": "object",
"required": [
"paymentRails"
],
"properties": {
"paymentRails": {
"type": "array",
"items": {
"type": "string",
"enum": [
"BANK_TRANSFER",
"MOBILE_MONEY"
]
}
}
}
}
]
},
"GhsAccountInfoBase": {
"type": "object",
"required": [
"accountType",
"bankName"
],
"description": "Required fields depend on the selected paymentRails:\n- BANK_TRANSFER: accountNumber, bankName\n- MOBILE_MONEY: bankName, phoneNumber",
"properties": {
"accountType": {
"type": "string",
"enum": [
"GHS_ACCOUNT"
]
},
"accountNumber": {
"type": "string",
"description": "The account number of the bank",
"minLength": 1,
"maxLength": 34
},
"bankName": {
"type": "string",
"description": "The name of the bank",
"minLength": 1,
"maxLength": 255
},
"phoneNumber": {
"type": "string",
"description": "The phone number in international format",
"minLength": 7,
"maxLength": 15,
"pattern": "^\\+[0-9]{6,14}$"
}
}
},
"GtqAccountInfo": {
"allOf": [
{
"$ref": "#/$defs/GtqAccountInfoBase"
},
{
"type": "object",
"required": [
"paymentRails"
],
"properties": {
"paymentRails": {
"type": "array",
"items": {
"type": "string",
"enum": [
"BANK_TRANSFER"
]
}
}
}
}
]
},
"GtqAccountInfoBase": {
"type": "object",
"required": [
"accountType",
"accountNumber",
"bankAccountType",
"bankName"
],
"properties": {
"accountType": {
"type": "string",
"enum": [
"GTQ_ACCOUNT"
]
},
"accountNumber": {
"type": "string",
"description": "The account number of the bank",
"minLength": 1,
"maxLength": 34
},
"bankAccountType": {
"type": "string",
"description": "The bank account type",
"enum": [
"CHECKING",
"SAVINGS"
]
},
"bankName": {
"type": "string",
"description": "The name of the beneficiary's bank",
"minLength": 1,
"maxLength": 255
}
}
},
"HkdAccountInfo": {
"allOf": [
{
"$ref": "#/$defs/HkdAccountInfoBase"
},
{
"type": "object",
"required": [
"paymentRails"
],
"properties": {
"paymentRails": {
"type": "array",
"items": {
"type": "string",
"enum": [
"BANK_TRANSFER"
]
}
}
}
}
]
},
"HkdAccountInfoBase": {
"type": "object",
"required": [
"accountType",
"bankName",
"accountNumber",
"swiftCode"
],
"properties": {
"accountType": {
"type": "string",
"enum": [
"HKD_ACCOUNT"
]
},
"bankName": {
"type": "string",
"description": "The name of the bank",
"minLength": 1,
"maxLength": 255
},
"accountNumber": {
"type": "string",
"description": "Hong Kong bank account number",
"minLength": 1,
"maxLength": 34
},
"swiftCode": {
"type": "string",
"description": "The SWIFT/BIC code of the bank",
"minLength": 8,
"maxLength": 11,
"pattern": "^[A-Z]{4}[A-Z]{2}[A-Z0-9]{2}([A-Z0-9]{3})?$"
}
}
},
"HtgAccountInfo": {
"allOf": [
{
"$ref": "#/$defs/HtgAccountInfoBase"
},
{
"type": "object",
"required": [
"paymentRails"
],
"properties": {
"paymentRails": {
"type": "array",
"items": {
"type": "string",
"enum": [
"MOBILE_MONEY"
]
}
}
}
}
]
},
"HtgAccountInfoBase": {
"type": "object",
"required": [
"accountType",
"phoneNumber"
],
"properties": {
"accountType": {
"type": "string",
"enum": [
"HTG_ACCOUNT"
]
},
"phoneNumber": {
"type": "string",
"description": "The phone number in international format",
"minLength": 7,
"maxLength": 15,
"pattern": "^\\+[0-9]{6,14}$"
}
}
},
"IdrAccountInfo": {
"allOf": [
{
"$ref": "#/$defs/IdrAccountInfoBase"
},
{
"type": "object",
"required": [
"paymentRails"
],
"properties": {
"paymentRails": {
"type": "array",
"items": {
"type": "string",
"enum": [
"BANK_TRANSFER"
]
}
}
}
}
]
},
"IdrAccountInfoBase": {
"type": "object",
"required": [
"accountType",
"bankName",
"accountNumber",
"swiftCode",
"phoneNumber"
],
"properties": {
"accountType": {
"type": "string",
"enum": [
"IDR_ACCOUNT"
]
},
"bankName": {
"type": "string",
"description": "The name of the bank",
"minLength": 1,
"maxLength": 255
},
"accountNumber": {
"type": "string",
"description": "Indonesian bank account number",
"minLength": 1,
"maxLength": 34
},
"swiftCode": {
"type": "string",
"description": "The SWIFT/BIC code of the bank",
"minLength": 8,
"maxLength": 11,
"pattern": "^[A-Z]{4}[A-Z]{2}[A-Z0-9]{2}([A-Z0-9]{3})?$"
},
"phoneNumber": {
"type": "string",
"description": "Indonesian phone number for e-wallet payments",
"minLength": 7,
"maxLength": 15,
"pattern": "^\\+62[0-9]{9,12}$"
}
}
},
"InrAccountInfo": {
"allOf": [
{
"$ref": "#/$defs/InrAccountInfoBase"
},
{
"type": "object",
"required": [
"paymentRails"
],
"properties": {
"paymentRails": {
"type": "array",
"items": {
"type": "string",
"enum": [
"UPI",
"NEFT",
"RTGS"
]
}
}
}
}
]
},
"InrAccountInfoBase": {
"type": "object",
"required": [
"accountType"
],
"description": "Required fields depend on the selected paymentRails:\n- NEFT: accountNumber, ifsc, rail\n- RTGS: accountNumber, ifsc, rail\n- UPI: vpa",
"properties": {
"accountType": {
"type": "string",
"enum": [
"INR_ACCOUNT"
]
},
"vpa": {
"type": "string",
"description": "The UPI Virtual Payment Address",
"minLength": 3,
"maxLength": 255,
"pattern": "^[a-zA-Z0-9.\\-_]+@[a-zA-Z0-9]+$"
},
"accountNumber": {
"type": "string",
"description": "Indian bank account number (9–18 digits)",
"minLength": 9,
"maxLength": 18,
"pattern": "^[0-9]{9,18}$"
},
"ifsc": {
"type": "string",
"description": "The Indian Financial System Code (IFSC) of the beneficiary's bank branch (NEFT/RTGS)",
"minLength": 11,
"maxLength": 11,
"pattern": "^[A-Z]{4}0[A-Z0-9]{6}$"
},
"rail": {
"type": "string",
"description": "The payment rail to route the payout over, for currencies that support more than one (e.g. NEFT or RTGS for INR).",
"minLength": 1,
"maxLength": 32
},
"bankName": {
"type": "string",
"description": "The name of the bank",
"minLength": 1,
"maxLength": 255
}
}
},
"InternalAccountStatus": {
"title": "Internal Account Status",
"type": "string",
"enum": [
"PENDING",
"ACTIVE",
"CLOSED",
"FROZEN",
"FAILED"
],
"description": "Status of a Grid internal account. The status determines whether the account can send or receive payments.\n\n- `PENDING`: The account is under review and is being provisioned. The account cannot send or receive payments until provisioning completes.\n- `ACTIVE`: The account is ready to send and receive payments.\n- `CLOSED`: The account cannot send or receive payments. A customer can initiate the closing of an internal account, after which the account transitions to this status.\n- `FROZEN`: The account cannot send or receive payments. Grid may freeze an account in response to compliance or fraud signals; payments are blocked while the account remains frozen.\n- `FAILED`: The account could not be provisioned. Grid was unable to create the underlying account, so it cannot send or receive payments and requires remediation."
},
"InternalAccountType": {
"title": "Internal Account Type",
"type": "string",
"enum": [
"INTERNAL_FIAT",
"INTERNAL_CRYPTO",
"EMBEDDED_WALLET"
],
"description": "Classification of an internal account.\n\n- `INTERNAL_FIAT`: A Grid-managed fiat holding account (for example, the USD holding account used as the source for Payouts flows).\n- `INTERNAL_CRYPTO`: A Grid-managed crypto holding account denominated in a stablecoin such as USDC.\n- `EMBEDDED_WALLET`: A self-custodial Embedded Wallet provisioned for the customer. Outbound transfers require a session signature produced by the customer's device — see the Embedded Wallets guide."
},
"JmdAccountInfo": {
"allOf": [
{
"$ref": "#/$defs/JmdAccountInfoBase"
},
{
"type": "object",
"required": [
"paymentRails"
],
"properties": {
"paymentRails": {
"type": "array",
"items": {
"type": "string",
"enum": [
"BANK_TRANSFER"
]
}
}
}
}
]
},
"JmdAccountInfoBase": {
"type": "object",
"required": [
"accountType",
"accountNumber",
"branchCode",
"bankAccountType",
"bankName"
],
"properties": {
"accountType": {
"type": "string",
"enum": [
"JMD_ACCOUNT"
]
},
"accountNumber": {
"type": "string",
"description": "The account number of the bank",
"minLength": 1,
"maxLength": 34
},
"branchCode": {
"type": "string",
"description": "The branch code",
"minLength": 5,
"maxLength": 5,
"pattern": "^[0-9]{5}$"
},
"bankAccountType": {
"type": "string",
"description": "The bank account type",
"enum": [
"CHECKING",
"SAVINGS"
]
},
"bankName": {
"type": "string",
"description": "The name of the bank",
"minLength": 1,
"maxLength": 255
}
}
},
"KesAccountInfo": {
"allOf": [
{
"$ref": "#/$defs/KesAccountInfoBase"
},
{
"type": "object",
"required": [
"paymentRails"
],
"properties": {
"paymentRails": {
"type": "array",
"items": {
"type": "string",
"enum": [
"MOBILE_MONEY"
]
}
}
}
}
]
},
"KesAccountInfoBase": {
"type": "object",
"required": [
"accountType",
"phoneNumber",
"provider"
],
"properties": {
"accountType": {
"type": "string",
"enum": [
"KES_ACCOUNT"
]
},
"phoneNumber": {
"type": "string",
"description": "Kenyan mobile money phone number",
"minLength": 7,
"maxLength": 15,
"pattern": "^\\+254[0-9]{9}$"
},
"provider": {
"type": "string",
"description": "The mobile money provider name",
"minLength": 1,
"maxLength": 255
}
}
},
"MwkAccountInfo": {
"allOf": [
{
"$ref": "#/$defs/MwkAccountInfoBase"
},
{
"type": "object",
"required": [
"paymentRails"
],
"properties": {
"paymentRails": {
"type": "array",
"items": {
"type": "string",
"enum": [
"MOBILE_MONEY"
]
}
}
}
}
]
},
"MwkAccountInfoBase": {
"type": "object",
"required": [
"accountType",
"phoneNumber",
"provider"
],
"properties": {
"accountType": {
"type": "string",
"enum": [
"MWK_ACCOUNT"
]
},
"phoneNumber": {
"type": "string",
"description": "The phone number in international format",
"minLength": 7,
"maxLength": 15,
"pattern": "^\\+[0-9]{6,14}$"
},
"provider": {
"type": "string",
"description": "The mobile money provider name",
"minLength": 1,
"maxLength": 255
}
}
},
"MxnAccountInfo": {
"allOf": [
{
"$ref": "#/$defs/MxnAccountInfoBase"
},
{
"type": "object",
"required": [
"paymentRails"
],
"properties": {
"paymentRails": {
"type": "array",
"items": {
"type": "string",
"enum": [
"SPEI"
]
}
}
}
}
]
},
"MxnAccountInfoBase": {
"type": "object",
"required": [
"accountType",
"clabeNumber"
],
"properties": {
"accountType": {
"type": "string",
"enum": [
"MXN_ACCOUNT"
]
},
"clabeNumber": {
"type": "string",
"description": "The CLABE number of the bank",
"m
# --- truncated at 32 KB (88 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/lightspark/refs/heads/main/json-schema/lightspark-internal-account-schema.json
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/lightspark-internal-account"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.