Lightspark · Schema

ExternalAccount

CompanyPaymentsCross-Border PaymentsStablecoinsBitcoinLightning NetworkEmbedded FinanceAgentic PaymentsCardsKYCFinancial ServicesForeign Exchange
View JSON Schema on GitHub

JSON Schema

lightspark-external-account-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/lightspark/main/json-schema/lightspark-external-account-schema.json",
  "title": "ExternalAccount",
  "x-generated": "2026-10-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/lightspark-agent-operations-api-openapi.yml#/components/schemas/ExternalAccount",
  "allOf": [
    {
      "type": "object",
      "required": [
        "id",
        "status",
        "currency",
        "accountInfo"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The system generated identifier of this account"
        },
        "customerId": {
          "type": "string",
          "description": "The customer this account is tied to, or null if the account is on behalf of the platform."
        },
        "status": {
          "$ref": "#/$defs/ExternalAccountStatus",
          "description": "Status of the external account"
        },
        "platformAccountId": {
          "type": "string",
          "description": "Optional platform-specific identifier for this account"
        },
        "currency": {
          "type": "string",
          "description": "The ISO 4217 currency code"
        },
        "defaultUmaDepositAccount": {
          "type": "boolean",
          "description": "Whether this account is the default UMA deposit account for the customer. If true, incoming UMA payments to this customer's UMA address will be automatically deposited into this account instead of the primary internal account. False if not provided. Note that at most, one external account can be set as the default UMA deposit account for a customer. If there is no default UMA deposit account, incoming UMA payments will be deposited into the primary internal account for the customer."
        },
        "beneficiaryVerificationStatus": {
          "$ref": "#/$defs/BeneficiaryVerificationStatus",
          "description": "The result of verifying the beneficiary name against the account holder name"
        },
        "beneficiaryVerifiedData": {
          "$ref": "#/$defs/BeneficiaryVerifiedData",
          "description": "Verified beneficiary data returned by the payment rail, if available"
        },
        "accountInfo": {
          "$ref": "#/$defs/ExternalAccountInfoOneOf"
        }
      }
    }
  ],
  "$defs": {
    "Address": {
      "type": "object",
      "required": [
        "line1",
        "postalCode",
        "country"
      ],
      "properties": {
        "line1": {
          "type": "string",
          "description": "Street address line 1"
        },
        "line2": {
          "type": "string",
          "description": "Street address line 2"
        },
        "city": {
          "type": "string",
          "description": "City"
        },
        "state": {
          "type": "string",
          "description": "State/Province/Region"
        },
        "postalCode": {
          "type": "string",
          "description": "Postal/ZIP code"
        },
        "country": {
          "type": "string",
          "description": "Country code (ISO 3166-1 alpha-2)"
        }
      }
    },
    "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})?$"
        }
      }
    },
    "AedBeneficiary": {
      "title": "Individual Beneficiary",
      "type": "object",
      "required": [
        "beneficiaryType",
        "address",
        "fullName"
      ],
      "properties": {
        "beneficiaryType": {
          "type": "string",
          "enum": [
            "INDIVIDUAL"
          ]
        },
        "fullName": {
          "type": "string",
          "description": "The full name of the beneficiary"
        },
        "birthDate": {
          "type": "string",
          "description": "The birth date of the beneficiary"
        },
        "nationality": {
          "type": "string",
          "description": "The nationality of the beneficiary"
        },
        "email": {
          "type": "string",
          "description": "The email of the beneficiary"
        },
        "phoneNumber": {
          "type": "string",
          "description": "The phone number of the beneficiary"
        },
        "countryOfResidence": {
          "type": "string",
          "description": "The country of residence of the beneficiary"
        },
        "address": {
          "$ref": "#/$defs/Address"
        }
      }
    },
    "AedExternalAccountInfo": {
      "title": "AED Account",
      "allOf": [
        {
          "$ref": "#/$defs/BaseExternalAccountInfo"
        },
        {
          "$ref": "#/$defs/AedAccountInfo"
        },
        {
          "type": "object",
          "required": [
            "beneficiary"
          ],
          "properties": {
            "beneficiary": {
              "oneOf": [
                {
                  "title": "Individual Beneficiary",
                  "$ref": "#/$defs/AedBeneficiary"
                },
                {
                  "title": "Business Beneficiary",
                  "$ref": "#/$defs/BusinessBeneficiary"
                }
              ]
            }
          }
        }
      ]
    },
    "BaseExternalAccountInfo": {
      "type": "object",
      "required": [
        "accountType"
      ],
      "properties": {
        "accountType": {
          "$ref": "#/$defs/ExternalAccountType"
        }
      }
    },
    "BaseWalletExternalAccountInfo": {
      "title": "Base Wallet",
      "allOf": [
        {
          "$ref": "#/$defs/BaseExternalAccountInfo"
        },
        {
          "$ref": "#/$defs/BaseWalletInfo"
        }
      ]
    },
    "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}$"
        }
      }
    },
    "BdtBeneficiary": {
      "title": "Individual Beneficiary",
      "type": "object",
      "required": [
        "beneficiaryType",
        "fullName"
      ],
      "properties": {
        "beneficiaryType": {
          "type": "string",
          "enum": [
            "INDIVIDUAL"
          ]
        },
        "fullName": {
          "type": "string",
          "description": "The full name of the beneficiary"
        },
        "birthDate": {
          "type": "string",
          "description": "The birth date of the beneficiary"
        },
        "nationality": {
          "type": "string",
          "description": "The nationality of the beneficiary"
        },
        "email": {
          "type": "string",
          "description": "The email of the beneficiary"
        },
        "phoneNumber": {
          "type": "string",
          "description": "The phone number of the beneficiary"
        },
        "countryOfResidence": {
          "type": "string",
          "description": "The country of residence of the beneficiary"
        },
        "address": {
          "$ref": "#/$defs/Address"
        }
      }
    },
    "BdtExternalAccountInfo": {
      "title": "BDT Account",
      "allOf": [
        {
          "$ref": "#/$defs/BaseExternalAccountInfo"
        },
        {
          "$ref": "#/$defs/BdtAccountInfo"
        },
        {
          "type": "object",
          "required": [
            "beneficiary"
          ],
          "properties": {
            "beneficiary": {
              "oneOf": [
                {
                  "title": "Individual Beneficiary",
                  "$ref": "#/$defs/BdtBeneficiary"
                },
                {
                  "title": "Business Beneficiary",
                  "$ref": "#/$defs/BusinessBeneficiary"
                }
              ]
            }
          }
        }
      ]
    },
    "BeneficiaryVerificationStatus": {
      "type": "string",
      "enum": [
        "MATCHED",
        "PARTIAL_MATCH",
        "NOT_MATCHED",
        "UNSUPPORTED",
        "CHECKED_BY_RECEIVING_FI",
        "PENDING"
      ],
      "description": "The result of verifying the beneficiary name against the account holder name.\n\n| Status | Description |\n|--------|-------------|\n| `MATCHED` | The beneficiary name is an exact match |\n| `PARTIAL_MATCH` | The beneficiary name is a fuzzy match |\n| `NOT_MATCHED` | The beneficiary name does not match |\n| `UNSUPPORTED` | The payment rail does not support name verification |\n| `CHECKED_BY_RECEIVING_FI` | Verification is deferred to the receiving financial institution (e.g. ACH) |\n| `PENDING` | Verification is still in progress |\n"
    },
    "BeneficiaryVerifiedData": {
      "type": "object",
      "properties": {
        "fullName": {
          "type": "string",
          "description": "The verified full name of the account holder as returned by the payment rail"
        }
      }
    },
    "BrlAccountInfo": {
      "allOf": [
        {
          "$ref": "#/$defs/BrlAccountInfoBase"
        },
        {
          "type": "object",
          "required": [
            "paymentRails"
          ],
          "properties": {
            "paymentRails": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "PIX"
                ]
              }
            }
          }
        }
      ]
    },
    "BrlAccountInfoBase": {
      "type": "object",
      "required": [
        "accountType",
        "pixKey",
        "pixKeyType",
        "taxId"
      ],
      "properties": {
        "accountType": {
          "type": "string",
          "enum": [
            "BRL_ACCOUNT"
          ]
        },
        "pixKey": {
          "type": "string",
          "description": "The PIX key (email, phone, CPF, CNPJ, or random)",
          "minLength": 1,
          "maxLength": 77
        },
        "pixKeyType": {
          "type": "string",
          "description": "The type of PIX key",
          "enum": [
            "CPF",
            "CNPJ",
            "EMAIL",
            "PHONE",
            "RANDOM"
          ]
        },
        "taxId": {
          "type": "string",
          "description": "The tax ID (CPF or CNPJ)",
          "minLength": 11,
          "maxLength": 14,
          "pattern": "^[0-9]{11,14}$"
        }
      }
    },
    "BrlBeneficiary": {
      "title": "Individual Beneficiary",
      "type": "object",
      "required": [
        "beneficiaryType",
        "fullName"
      ],
      "properties": {
        "beneficiaryType": {
          "type": "string",
          "enum": [
            "INDIVIDUAL"
          ]
        },
        "fullName": {
          "type": "string",
          "description": "The full name of the beneficiary"
        },
        "birthDate": {
          "type": "string",
          "description": "The birth date of the beneficiary"
        },
        "nationality": {
          "type": "string",
          "description": "The nationality of the beneficiary"
        },
        "email": {
          "type": "string",
          "description": "The email of the beneficiary"
        },
        "phoneNumber": {
          "type": "string",
          "description": "The phone number of the beneficiary"
        },
        "countryOfResidence": {
          "type": "string",
          "description": "The country of residence of the beneficiary"
        },
        "address": {
          "$ref": "#/$defs/Address"
        }
      }
    },
    "BrlExternalAccountInfo": {
      "title": "BRL Account",
      "allOf": [
        {
          "$ref": "#/$defs/BaseExternalAccountInfo"
        },
        {
          "$ref": "#/$defs/BrlAccountInfo"
        },
        {
          "type": "object",
          "required": [
            "beneficiary"
          ],
          "properties": {
            "beneficiary": {
              "oneOf": [
                {
                  "title": "Individual Beneficiary",
                  "$ref": "#/$defs/BrlBeneficiary"
                },
                {
                  "title": "Business Beneficiary",
                  "$ref": "#/$defs/BusinessBeneficiary"
                }
              ]
            }
          }
        }
      ]
    },
    "BusinessBeneficiary": {
      "title": "Business Beneficiary",
      "type": "object",
      "required": [
        "beneficiaryType",
        "legalName"
      ],
      "properties": {
        "beneficiaryType": {
          "type": "string",
          "enum": [
            "BUSINESS"
          ]
        },
        "legalName": {
          "type": "string",
          "description": "The legal name of the business"
        },
        "registrationNumber": {
          "type": "string",
          "description": "The registration number of the business"
        },
        "taxId": {
          "type": "string",
          "description": "The tax identification number of the business"
        },
        "email": {
          "type": "string",
          "description": "The email of the beneficiary"
        },
        "phoneNumber": {
          "type": "string",
          "description": "The phone number of the beneficiary"
        },
        "countryOfResidence": {
          "type": "string",
          "description": "The country of residence of the beneficiary"
        },
        "address": {
          "$ref": "#/$defs/Address"
        }
      }
    },
    "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
        }
      }
    },
    "BwpBeneficiary": {
      "title": "Individual Beneficiary",
      "type": "object",
      "required": [
        "beneficiaryType",
        "fullName"
      ],
      "properties": {
        "beneficiaryType": {
          "type": "string",
          "enum": [
            "INDIVIDUAL"
          ]
        },
        "fullName": {
          "type": "string",
          "description": "The full name of the beneficiary"
        },
        "birthDate": {
          "type": "string",
          "description": "The birth date of the beneficiary"
        },
        "nationality": {
          "type": "string",
          "description": "The nationality of the beneficiary"
        },
        "email": {
          "type": "string",
          "description": "The email of the beneficiary"
        },
        "phoneNumber": {
          "type": "string",
          "description": "The phone number of the beneficiary"
        },
        "countryOfResidence": {
          "type": "string",
          "description": "The country of residence of the beneficiary"
        },
        "address": {
          "$ref": "#/$defs/Address"
        }
      }
    },
    "BwpExternalAccountInfo": {
      "title": "BWP Account",
      "allOf": [
        {
          "$ref": "#/$defs/BaseExternalAccountInfo"
        },
        {
          "$ref": "#/$defs/BwpAccountInfo"
        },
        {
          "type": "object",
          "required": [
            "beneficiary"
          ],
          "properties": {
            "beneficiary": {
              "oneOf": [
                {
                  "title": "Individual Beneficiary",
                  "$ref": "#/$defs/BwpBeneficiary"
                },
                {
                  "title": "Business Beneficiary",
                  "$ref": "#/$defs/BusinessBeneficiary"
                }
              ]
            }
          }
        }
      ]
    },
    "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}$"
        }
      }
    },
    "CadBeneficiary": {
      "title": "Individual Beneficiary",
      "type": "object",
      "required": [
        "beneficiaryType",
        "fullName"
      ],
      "properties": {
        "beneficiaryType": {
          "type": "string",
          "enum": [
            "INDIVIDUAL"
          ]
        },
        "fullName": {
          "type": "string",
          "description": "The full name of the beneficiary"
        },
        "birthDate": {
          "type": "string",
          "description": "The birth date of the beneficiary"
        },
        "nationality": {
          "type": "string",
          "description": "The nationality of the beneficiary"
        },
        "email": {
          "type": "string",
          "description": "The email of the beneficiary"
        },
        "phoneNumber": {
          "type": "string",
          "description": "The phone number of the beneficiary"
        },
        "registrationNumber": {
          "type": "string",
          "description": "The registration number of the beneficiary"
        },
        "countryOfResidence": {
          "type": "string",
          "description": "The country of residence of the beneficiary"
        },
        "address": {
          "$ref": "#/$defs/Address"
        }
      }
    },
    "CadExternalAccountInfo": {
      "title": "CAD Account",
      "allOf": [
        {
          "$ref": "#/$defs/BaseExternalAccountInfo"
        },
        {
          "$ref": "#/$defs/CadAccountInfo"
        },
        {
          "type": "object",
          "required": [
            "beneficiary"
          ],
          "properties": {
            "beneficiary": {
              "oneOf": [
                {
                  "title": "Individual Beneficiary",
                  "$ref": "#/$defs/CadBeneficiary"
                },
                {
                  "title": "Business Beneficiary",
                  "$ref": "#/$defs/BusinessBeneficiary"
                }
              ]
            }
          }
        }
      ]
    },
    "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}$"
        }
      }
    },
    "CnyBeneficiary": {
      "title": "Individual Beneficiary",
      "type": "object",
      "required": [
        "beneficiaryType",
        "fullName"
      ],
      "properties": {
        "beneficiaryType": {
          "type": "string",
          "enum": [
            "INDIVIDUAL"
          ]
        },
        "fullName": {
          "type": "string",
          "description": "The full name of the beneficiary"
        },
        "birthDate": {
          "type": "string",
          "description": "The birth date of the beneficiary"
        },
        "nationality": {
          "type": "string",
          "description": "The nationality of the beneficiary"
        },
        "email": {
          "type": "string",
          "description": "The email of the beneficiary"
        },
        "phoneNumber": {
          "type": "string",
          "description": "The phone number of the beneficiary"
        },
        "countryOfResidence": {
          "type": "string",
          "description": "The country of residence of the beneficiary"
        },
        "address": {
          "$ref": "#/$defs/Address"
        }
      }
    },
    "CnyExternalAccountInfo": {
      "title": "CNY Account",
      "allOf": [
        {
          "$ref": "#/$defs/BaseExternalAccountInfo"
        },
        {
          "$ref": "#/$defs/CnyAccountInfo"
        },
        {
          "type": "object",
          "required": [
            "beneficiary"
          ],
          "properties": {
            "beneficiary": {
              "oneOf": [
                {
                  "title": "Individual Beneficiary",
                  "$ref": "#/$defs/CnyBeneficiary"
                },
                {
                  "title": "Business Beneficiary",
                  "$ref": "#/$defs/BusinessBeneficiary"
                }
              ]
            }
          }
        }
      ]
    },
    "CopAccountInfo": {
      "allOf": [
        {
          "$ref": "#/$defs/CopAccountInfoBase"
        },
        {
          "type": "object",
          "required": [
            "paymentRails"
          ],
          "properties": {
            "paymentRails": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "BANK_TRANSFER",
                  "MOBILE_MONEY"
                ]
              }
            }
          }
        }
      ]
    },
    "CopAccountInfoBase": {
      "type": "object",
      "required": [
        "accountType",
        "bankName"
      ],
      "description": "Required fields depend on the selected paymentRails:\n- BANK_TRANSFER: accountNumber, bankAccountType, bankName\n- MOBILE_MONEY: bankName, phoneNumber",
      "properties": {
        "accountType": {
          "type": "string",
          "enum": [
            "COP_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 bank",
          "minLength": 1,
          "maxLength": 255
        },
        "phoneNumber": {
          "type": "string",
          "description": "The phone number in international format",
          "minLength": 7,
          "maxLength": 15,
          "pattern": "^\\+[0-9]{6,14}$"
        }
      }
    },
    "CopBeneficiary": {
      "title": "Individual Beneficiary",
      "type": "object",
      "required": [
        "beneficiaryType",
        "fullName"
      ],
      "properties": {
        "beneficiaryType": {
          "type": "string",
          "enum": [
            "INDIVIDUAL"
          ]
        },
        "fullName": {
          "type": "string",
          "description": "The full name of the beneficiary"
        },
        "birthDate": {
          "type": "string",
          "description": "The birth date of the beneficiary"
        },
        "nationality": {
          "type": "string",
          "description": "The nationality of the beneficiary"
        },
        "email": {
          "type": "string",
          "description": "The email of the beneficiary"
        },
        "phoneNumber": {
          "type": "string",
          "description": "The phone number of the beneficiary"
        },
        "countryOfResidence": {
          "type": "string",
          "description": "The country of residence of the beneficiary"
        },
        "address": {
          "$ref": "#/$defs/Address"
        },
        "documentType": {
          "type": "string",
          "description": "Identity document type (Colombia)",
          "enum": [
            "CC",
            "CE",
            "TI",
            "NIT",
            "PP"
          ]
        },
        "documentNumber": {
          "type": "string",
          "description": "The identity document number",
          "minLength": 1,
          "maxLength": 50
        }
      }
    },
    "CopExternalAccountInfo": {
      "title": "COP Account",
      "allOf": [
        {
          "$ref": "#/$defs/BaseExternalAccountInfo"
        },
        {
          "$ref": "#/$defs/CopAccountInfo"
        },
        {
          "type": "object",
          "required": [
            "beneficiary"
          ],
          "properties": {
            "beneficiary": {
              "oneOf": [
                {
                  "title": "Individual Beneficiary",
                  "$ref": "#/$defs/CopBeneficiary"
                },
                {
                  "title": "Business Beneficiary",
                  "$ref": "#/$defs/BusinessBeneficiary"
                }
              ]
            }
          }
        }
      ]
    },
    "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})?$"
        }
      }
    },
    "DkkBeneficiary": {
      "title": "Individual Beneficiary",
      "type": "object",
      "required": [
        "beneficiaryType",
        "fullName"
      ],
      "properties": {
        "beneficiaryType": {
          "type": "string",
          "enum": [
            "INDIVIDUAL"
          ]
        },
        "fullName": {
          "type": "string",
          "description": "The full name of the beneficiary"
        },
        "birthDate": {
          "type": "string",
          "description": "The birth date of the beneficiary"
        },
        "nationality": {
          "type": "string",
          "description": "The nationality of the beneficiary"
        },
    

# --- truncated at 32 KB (138 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/lightspark/refs/heads/main/json-schema/lightspark-external-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.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/lightspark-external-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.