---
title: "List invoice add-ons"
method: GET
path: "/merchant-account/{merchantId}/invoice-addons"
tags: ["Cost Ingestion"]
---

# List invoice add-ons

`GET /merchant-account/{merchantId}/invoice-addons`

## Request

- Base URL: `http://localhost:8080`
- URL: `http://localhost:8080/merchant-account/{merchantId}/invoice-addons`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

List the invoice-derived cost add-ons stored per connector.

## Path parameters

- `merchantId` string, required

## Response `200`

Invoice add-ons

- AddonDto[]
  - `connector` string
  - `pct_addon_bps` number, double
  - `fixed_addon` number, double
  - `invoice_ref` string
  - `subtotal_ex_tax` number, double, nullable
  - `card_volume` number, double, nullable
  - `txn_count` integer, nullable
  - `currency` string
  - `period_start` string, nullable
  - `period_end` string, nullable
  - `updated_at` string

## Changes

- **2026-08-04** `36e7a0972ee6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/juspay/apis/decision-engine/changes/merchant-account/:merchantId/invoice-addons/get.md)

---

[API](https://skmtc.dev/juspay/apis/decision-engine.md) - [All operations](https://skmtc.dev/juspay/apis/decision-engine/llms.txt) - [OpenAPI document](https://skmtc.dev/juspay/apis/decision-engine/revisions/718ef5ac8634?raw)