Skip to content

Commit 31a1683

Browse files
pengyingclaude
andauthored
docs: add Discoveries API usage to external accounts guide (#328)
## Summary - Adds a new "Look up bank names with the Discoveries API" section to the external accounts snippet - Explains that countries like the Philippines, Nigeria, and South Africa require a `bankName` that must match Grid's expected values - Shows example request/response for the Discoveries API - Notes that `displayName` can be shown to users and the list can be filtered client-side ## Test plan - [ ] Run `make mint` and verify the new section renders correctly on external account pages - [ ] Verify the Discoveries API link resolves to the correct API reference page - [ ] Confirm the section appears across all use cases (payouts, ramps, rewards, global P2P) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent facad32 commit 31a1683

1 file changed

Lines changed: 32 additions & 0 deletions

File tree

mintlify/snippets/external-accounts.mdx

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,38 @@ External accounts are bank accounts, cryptocurrency wallets, or payment destinat
88
Platform accounts are managed at the organization level.
99
</Info>
1010

11+
## Look up bank names with the Discoveries API
12+
13+
Some countries require a `bankName` when creating an external account — including the Philippines, Nigeria, South Africa, and others. The `bankName` value must match exactly what Grid expects.
14+
15+
Use the [Discoveries API](/api-reference/discoveries/list-available-receiving-institution-names) to retrieve the list of valid bank names for a given country and currency:
16+
17+
```bash cURL
18+
curl -X GET 'https://api.lightspark.com/grid/2025-10-13/discoveries?country=PH&currency=PHP' \
19+
-H 'Authorization: Basic $GRID_CLIENT_ID:$GRID_CLIENT_SECRET'
20+
```
21+
22+
```json Response
23+
{
24+
"data": [
25+
{
26+
"bankName": "BDO Unibank",
27+
"displayName": "BDO Unibank",
28+
"country": "PH",
29+
"currency": "PHP"
30+
},
31+
{
32+
"bankName": "BPI",
33+
"displayName": "Bank of the Philippine Islands",
34+
"country": "PH",
35+
"currency": "PHP"
36+
}
37+
]
38+
}
39+
```
40+
41+
Use `bankName` from the response as the `bankName` value when creating an external account. The `displayName` is a human-friendly label you can show to your users. You can filter the list on the client side as the user types to provide a bank search experience.
42+
1143
## Create external accounts by region or wallet
1244

1345
<Tabs>

0 commit comments

Comments
 (0)