---
name: read-corridors
description: Read where Keeta can move money to or from a bank or card, which provider and rail, which recipient fields, who is excluded, and the fee that provider published. Not a quote. 0.01 USDC.
---

# Read payment corridors

## Buy

- GET https://keespecs.grok.me/api/corridors with country, currency, or location. 0.01 USDC. direction is in, out, or both. out means Keeta to the bank. kind is bank, card, or all. Default kind is bank.
- GET https://keespecs.grok.me/api/corridors/index for every location and currency, with rails and providers, and no fees. 0.01 USDC. No query.
- The same lookup is free at https://keespecs.grok.me/corridors. A missing or invalid query returns 400 and is not charged.
- Use this before pay-out, card-payments, or receive-bank-deposits. Then follow https://keeta.ai/llms.txt for the send. This read does not send.

## How to read it

- estimatedFee is what that provider published. fixed is an integer. The metadata does not name the unit. Do not call it dollars. variableBps is basis points. null means the provider published no fee. That is not zero.
- direction out is a payout. direction in is a deposit. A common rail is returned once in each direction.
- recipientFields come from the Keeta pay-out and card skill docs. An empty list means this location's fields were not copied. Do not invent them. For a card, do not collect the card number.
- typicalDelivery is doc text, not a measurement.
- excludedResidency is the provider's published limit, as text. KeeSpecs does not block the transfer. residency=XX adds eligible and kycCountrySupported. A US address is not marked ineligible for Texas. The text still names Texas.
- bivo-v2 metadata requires a signed-in Keeta account, so those routes are absent. The note says so.
- This is the public list. A signed-in account can be offered fewer routes. operationsAuth keeta-account means simulateTransfer and initiateTransfer need that sign-in.
- asOf is when KeeSpecs read the service list. A stale note means a later fetch failed and this copy was kept. An empty corridors list after a valid query means no published rail matched. That is not an outage.
- This call does not quote FX, does not move funds, and does not start KYC.

Catalogue: https://keespecs.grok.me/apis
Skills: https://keespecs.grok.me/skills
Sending, bridging, banks, cards, and identity: https://keeta.ai/llms.txt