---
title: "List dispute fees"
method: GET
path: "/v1/fee"
tags: ["Fees"]
---

# List dispute fees

`GET /v1/fee`

Get a list of fees with filter and paging options.

## Query parameters

- `beginDate` string
- `endDate` string
- `claimId` string
- `cardId` string
- `networkFeeId` string
- `status` 'PENDING' | 'PROCESSED' | 'FAILED'
- `page` integer
- `perPage` integer

## Headers

- `x-tenant` string, required

## Response `200`

OK

- DisputeFeeResponse[]
  - `id` number — Dispute fee ID
  - `arn` string — Acquirer reference number. **REQUIRED** if `claim_id` is not passed.
  - `transaction_amount` number, double — Transaction amount. **REQUIRED** if `claim_id` is not passed.
  - `transaction_date` string, date-time — Transaction date, format = yyyy-mm-dd hh:mm:ss. **REQUIRED** if `claim_id` is not passed.
  - `card_id` integer — Enrolled card ID
  - `card_acceptor_code` string — Merchant ID associated with this fee collection..if any.
  - `country_code` string — ISO country code.
  - `destination_member` string — Destination member for the fee collection. These values are known to the network and identify either the acquirer or issuer.
  - `fee_date` string, date — Date the fee was attached to the claim, format = yyyy-mm-dd
  - `currency` string — ISO 4217 currency code.
  - `amount` number, double — Fee amount.
  - `message` string — Message regarding fee - 100 chars maximum.
  - `reason_code` string — Collection reason code. These codes can be found in Mastercard's [Global Clearing Management System Reference Manual](https://pismoassets.pismo.io/pismo-docs/mc_gcms_rm.pdf) starting on page 408.
  - `settlement_date` string, date — Settlement date, format = yyyy-mm-dd.
  - `control_number` string — Control number
  - `credit_sender` boolean — Credit the sender? Default is `false`.
  - `credit_receiver` boolean — Should receiver be credited?
  - `network_brand_type` 'Visa' | 'Mastercard' | 'Elo' — Network brand
  - `status` 'PENDING' | 'PROCESSED' | 'FAILED' — Dispute fee status - `PENDING`, `PROCESSED`, or `FAILED`.
  - `chargeback_ref_num` string — Chargeback reference number
  - `reconciliation_amount` number, double — Reconciliation amount
  - `reconciliation_currency` string — Reconciliation currency
  - `japan_common_merchant_code` string — Japanese common merchant codes
  - `installment_data` string — Installment data
  - `reply_fee_id` string — Fee ID to send to reply to created fee.
  - `reject_reason` string — Reject reason
  - `created_at` string — When dispute created, format = yyyy-mm-ddThh:mm:ss"
  - `updated_at` string, date-time — Datetime program calendar strategy was updated. Format = YYYY-MM-DDTHH:MM:SS:MM
  - `created_at_utc` string, date-time — Dispute created in UTC date/time.
  - `updated_at_utc` string — When dispute updated in UTC date/time.

## Other responses

- `400` — Bad request
- `401` — Access token is missing or invalid
- `404` — Not Found
- `422` — Unprocessable entity
- `500` — Internal server error

---

[API](https://skmtc.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/revisions/935b62e16de4/schema)