---
title: "Cross-Border B2B Fee Calculator"
method: POST
path: "/v1/tools/compute_cross_border_fees"
tags: ["TODO_TAGS_REVIEW", "TODO_AP2_EXPORT_REVIEW"]
---

# Cross-Border B2B Fee Calculator

`POST /v1/tools/compute_cross_border_fees`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/compute_cross_border_fees`
- Auth: none declared

Itemizes a single cross-border B2B invoice's total cost stack: FX spread cost, payment-method/correspondent fee, VAT or reverse-charge cost, documentary-credit cost, and reconciliation cost, plus total cost as a percentage of invoice value. Ports the calculation from tools/141-cross-border-b2b-fee-calculator.html into a provable kernel. VAT treatment, documentary-credit cost, and correspondent fees are caller-supplied, never vendored. Pairs with the already-shipped compare_corridor_cost node (art-249), which benchmarks a remittance corridor against World Bank RPW / SDG 10.c targets rather than itemizing a single invoice.

**Tool URL:** https://ainumbers.co/chaingraph/art-367-compute-cross-border-fees.html

## Request body

- object
  - `dest_country` unknown, required
  - `doc_cost` number
  - `fx_spread_bps` number: Amount in basis points
  - `invoice_amount` number
  - `method_fee` number
  - `origin_country` unknown, required
  - `recon_cost` number
  - `vat_rate` number

## Response `200`

Successful tool execution result

- object
  - `dest_country` string
  - `disambiguation` string
  - `doc_cost` integer
  - `fx_cost` number
  - `fx_spread_bps` integer
  - `invoice_amount` integer
  - `method_fee` integer
  - `origin_country` string
  - `pct_of_invoice` number
  - `recon_cost` integer
  - `regulatory_basis` string
  - `total_cost` number
  - `vat_cost` integer
  - `vat_rate` integer

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)