---
title: "Claim Fees"
method: POST
path: "/fees/claim"
tags: ["fees"]
---

# Claim Fees

`POST /fees/claim`

Claim accrued fees for the authenticated organization

## Headers

- `Authorization-Signature` string, required

## Request body

- ClaimFeesRequest
  - `currency` CurrencyBase, required
    - `address` string, nullable
    - `chain_id` 1 | 10 | 56 | 137 | 8453 | 42161 | 20000000000001 | 30000000000001 | 30000000000002, required
  - `recipient` string, required
  - `metadata` OrderMetadata
    - `items` MetadataItems[]
      - `name` string, nullable
      - `description` string, nullable
      - `image` string, nullable
      - `quantity` integer, nullable
      - `unit_price` number, nullable
      - `currency` string, nullable
    - `refund` MetadataRefund
      - `name` string, nullable
      - `reason` string, nullable
      - `additional_info` string, nullable
      - `refund_amount` number, nullable
      - `currency` string, nullable

## Response `200`

Fees claimed successfully

- union
  - ClaimFeesResponse
    - `claim_order_id` string, required
    - `source_transaction_hash` string, required
    - `transaction_hash` string, required — Use 'source_transaction_hash' instead
    - `source_chain_id` 1 | 10 | 56 | 137 | 8453 | 42161 | 20000000000001 | 30000000000001 | 30000000000002, required
    - `currency` CurrencyAmount, required
      - `ui_amount` number, required — Approximate numeric amount. Do not use for payment construction; use raw_amount for exact amounts and ui_amount_display for display.
      - `ui_amount_display` string, required
      - `raw_amount` string, required — A big integer represented as a string to preserve precision
      - `value_usd` number, required
  - object
    - `message` string, required

## Other responses

- `400` — Bad Request - Invalid recipient address format for selected chain
- `401` — Unauthorized - Authentication required
- `422` — Unprocessable Entity - Invalid request body format
- `500` — Internal Server Error

---

[API](https://skmtc.net/coinvoyage/apis/coinvoyage-api.md) · [All operations](https://skmtc.net/coinvoyage/apis/coinvoyage-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coinvoyage/coinvoyage-api/revisions/29e628200554/schema)