---
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-08-14** `aaa1fb8782c8` — 1 warning
  - added the new `EXTERNAL_ACCOUNT_VERIFICATION_REQUIRED` enum value to the `code` response property for the response status `400`
- **2026-08-13** `df12ec487f0e` — 1 warning
  - added the new `TRANSACTION_SIZE_LIMIT_EXCEEDED` enum value to the `code` response property for the response status `400`
- **2026-08-11** `b06902b6595a` — 1 warning
  - added the new `CARDHOLDER_KYC_NOT_APPROVED` enum value to the `code` response property for the response status `400`
- **2026-08-06** `526036c12609` — 1 warning
  - added the new `END_USER_TERMS_VERSION_NOT_FOUND` enum value to the `code` response property for the response status `400`
- **2026-07-31** `b21ed434ee6e` — 1 info
  - added the optional property `details/errors` to the response with the `400` status

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

---

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