List available receiving institution names

Retrieve available payment institution names for a given country and currency. Use this endpoint to look up supported banks and payment providers for a specific corridor. If no country and currency parameter are provided, all payment institutions will be returned

The bankName field in each result is the value to pass as bankName when creating an external account via POST /customers/external-accounts.

GET /discoveries

cURL

cURL

curl --request GET \
  --url https://api.lightspark.com/grid/2025-10-13/discoveries \
  --header 'Authorization: Basic <encoded-value>'

200

{
  "data": [
    {
      "bankName": "BDO Unibank",
      "displayName": "BDO Unibank",
      "country": "PH",
      "currency": "PHP"
    },
    {
      "bankName": "BPI",
      "displayName": "Bank of the Philippine Islands",
      "country": "PH",
      "currency": "PHP"
    }
  ]
}

Authorizations

Authorization · string · header · required

API token authentication using format <api token id>:<api client secret>

Query Parameters

country · string

ISO 3166-1 alpha-2 country code (e.g. PH)

currency · string

ISO 4217 currency code (e.g. PHP)

Response

200

application/json

Successful operation

data · object[]

List of payment rails matching the filter criteria

Show child attributes