Get fee profile configuration
Retrieve the complete fee configuration for your client: every fee profile (enriched with product info), all promotions referenced by those profiles, and a summary count. Takes no query parameters; a client with no profiles still returns 200 with empty arrays.
All monetary and rate values are decimal strings. Each entry in fee_profiles[] includes:
product_code/product_name,currency, andaccount_type(the rail this profile applies to, e.g.ACH,WIRE,SPEI;nullmeans it applies to all rails).effective_date,expiry_date(nullable), andstatus(boolean —trueis active).base_feesandclient_markup, each{ fixed_fee, percentage_fee, fx_markup }(fx_markupmay benull).network_fees[],penalty_configs[], andfastpay_config.
promotions[] lists distinct promotions across your profiles, and summary reports total_profiles and active_promotions.
Example response (200):
{
"client_id": "550e8400-e29b-41d4-a716-446655440000",
"fee_profiles": [
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"product_code": "PAYOUT",
"product_name": "Payout",
"currency": "MXN",
"account_type": "SPEI",
"effective_date": "2026-01-01",
"expiry_date": null,
"status": true,
"base_fees": {
"fixed_fee": "0.50",
"percentage_fee": "0.0025",
"fx_markup": "0.015"
},
"network_fees": [
{
"network": "POLYGON",
"processing_fee": "0.10"
}
],
"client_markup": {
"fixed_fee": "0",
"percentage_fee": "0.001",
"fx_markup": null
},
"penalty_configs": [],
"fastpay_config": {
"individual_fx_markup": "0.02",
"business_fx_markup": "0.015"
}
}
],
"promotions": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "Launch Promo",
"promo_type": "FEE_DISCOUNT",
"applicable_products": [
"PAYOUT"
],
"max_usage_per_user": 5,
"max_total_usage": 1000,
"start_date": "2026-01-01",
"end_date": "2026-03-31",
"status": true,
"conditions": {
"min_amount": "100.00"
}
}
],
"summary": {
"total_profiles": 1,
"active_promotions": 1
}
}
Authorizations
Access token from POST /auth (the data.access_token value).
API key issued by Kira. Required on every request, including /auth.
Headers
"2026-04-14"
Path Parameters
Client UUID (your own client identifier).
Response
Success.