---
title: "List available receiving institution names"
method: GET
path: "/discoveries"
tags: ["Discoveries"]
---

# List available receiving institution names

`GET /discoveries`

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`.

## Query parameters

- `country` string
- `currency` string

## Response `200`

Successful operation

- DiscoveryListResponse
  - `data` object[] — List of payment rails matching the filter criteria
    - `bankName` string, required — Canonical name for this payment rail. Pass this value as `bankName` when creating an external account.
    - `displayName` string, required — Human-friendly display name for this payment rail.
    - `country` string, required — ISO 3166-1 alpha-2 country code.
    - `currency` string, required — ISO 4217 currency code.

## Other responses

- `400` — Bad request - Invalid parameters
- `401` — Unauthorized
- `500` — Internal service error

## Changes

- **2026-05-28** `d0bce562bffd` — 5 warning
  - added the new `REQUEST_ID_MISSING` enum value to the `code` response property for the response status `401`
  - added the new `WALLET_SIGNATURE_BODY_MISMATCH` enum value to the `code` response property for the response status `401`
  - added the new `WALLET_SIGNATURE_INVALID` enum value to the `code` response property for the response status `401`
  - added the new `WALLET_SIGNATURE_MALFORMED` enum value to the `code` response property for the response status `401`
  - …1 more
- **2026-04-27** `5b8a8161eeb3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/lightsparkdev/apis/grid-api/changes/discoveries/get.md)

---

[API](https://skmtc.dev/lightsparkdev/apis/grid-api.md) · [All operations](https://skmtc.dev/lightsparkdev/apis/grid-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lightsparkdev/grid-api/revisions/d0bce562bffd/schema)