target path value on the normal pair and amount-conversion endpoints.
The CBSL experience uses the same project credentials, request envelope, and Currency endpoints as a standard conversion. No separate provider account or CBSL-specific key is required.
CBSL API endpoints
Use one of these complete URLs. Replace{base}, {target}, and {amount} with your request values.
Rate only
GET — rate only
Convert an amount at a CBSL rate
GET — rate and converted amount
The three CBSL target codes
LKR-SELL
CBSL Telegraphic Transfer selling rate: the published rate at which a bank sells the foreign currency.
LKR-BUY
CBSL Telegraphic Transfer buying rate: the published rate at which a bank buys the foreign currency.
LKR-CBSL
CBSL indicative rate: the published indicative LKR rate for the selected base currency.
LKR-SELL — Telegraphic Transfer selling rate
UseLKR-SELL when you need the CBSL Telegraphic Transfer selling rate for the selected base currency.
curl
Response
LKR-BUY — Telegraphic Transfer buying rate
UseLKR-BUY when you need the CBSL Telegraphic Transfer buying rate for the selected base currency.
curl
Response shape
LKR-CBSL — indicative rate
UseLKR-CBSL when you need the CBSL indicative LKR rate for the selected base currency.
curl
Response shape
Rates, request IDs, and update times are dynamic. The
LKR-BUY and LKR-CBSL examples show the real response structure; do not reuse the illustrated LKR-SELL value as a buy or indicative rate.Direct CBSL data and fallback behaviour
AvraAPI currently stores direct CBSL records for these base currencies:USD, GBP, EUR, JPY, CNY, and AUD.
For one of these bases, a CBSL target code selects the matching published CBSL buy, sell, or indicative value. If the base is outside that set, or AvraAPI has no usable direct CBSL record at that moment, the API deliberately falls back to the normal LKR cross-rate and still returns 200.
This means a target such as LKR-SELL is a request for that CBSL rate type, not a response field that proves the result came from a direct CBSL record. The current response does not include a source or fallback flag. If your workflow requires proof of a particular published CBSL value, retain the response, check last_updated, and apply your own business approval before using it.
What last_updated means
Every rate response contains last_updated: the source-update value AvraAPI currently holds for the rate data. It helps you decide whether data is recent enough for your use case, but its string format is not a versioned API guarantee. It is not a settlement timestamp and it does not replace your own pricing, reconciliation, or audit controls.
CBSL terminology
CBSL describes its buying and selling values as daily Telegraphic Transfer (TT) exchange rates quoted by commercial banks in Colombo, while the USD/LKR spot indicative value is a weighted average of domestic inter-bank transactions. AvraAPI keeps those rate types separate throughLKR-BUY, LKR-SELL, and LKR-CBSL; do not substitute one for another without understanding your business requirement. CBSL exchange-rate information and CBSL daily buying and selling rate page explain the source terminology.
Next steps
- Browse the four Currency endpoints in the sidebar for their exact request and response contracts.
- Start with List supported currency codes when you need to validate a code before calling a pair endpoint.
- Read REST API for credential and environment rules.