Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Kora Currency Conversion API

Exchange rates and multi-currency conversions.

Kora Currency Conversion API is one of 7 APIs that Kora publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Currency Conversion. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 4 operations across 3 paths, and defines 4 schemas. It is described by OpenAPI 3.0.3, at version 1.0.

Requests are made against a single base URL, https://api.korapay.com/merchant/api/v1.

4 operations 3 paths 4 schemas 2 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0
Base URL
https://api.korapay.com/merchant/api/v1
Authentication
HTTP Bearer, HTTP Bearer
Resource Areas
1

Authentication & Security 2

Kora Currency Conversion API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (secretKeyAuth). It accepts HTTP bearer tokens (publicKeyAuth). By default, every request must be authenticated.

  • secretKeyAuth — Secret API key passed as Authorization: Bearer sk.... Required for server-side and financial operations (payouts, balances, virtual bank accounts, refunds, con…
  • publicKeyAuth — Public API key (pk...) used from client-side code to initiate charges. Cannot access financial data.

Paths & Operations 4

Across 3 paths, the API surfaces 4 operations — 2 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Currency Conversion 4

Exchange rates and multi-currency conversions.

POST
/conversions/rates
Get exchange rate
getExchangeRate body → 200401
POST
/conversions
Initiate a currency conversion
initiateConversion body → 200401
GET
/conversions
List conversion history
listConversions 4 params → 200401
GET
/conversions/{reference}
Retrieve a conversion
getConversion 1 param → 200401404

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are ConversionInput (4 properties), ErrorResponse (3 properties), ConversionResponse (3 properties), ExchangeRateInput (3 properties). Each schema is shown below with its type and property counts.

ExchangeRateInput
object
3 properties 3 required
ConversionResponse
object
3 properties
ConversionInput
object
4 properties 4 required
ErrorResponse
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

korapay-currency-conversion-api-openapi.yml Raw ↑

Other APIs Kora publishes across the network.

Kora Balances API
Kora Charges API
Kora Misc API
Kora Payouts API
Kora Refunds API
Kora Virtual Bank Accounts API