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

# Claim Fees

`POST /fees/claim`

## Request

- Base URL: `https://api.coinvoyage.io/v3`
- URL: `https://api.coinvoyage.io/v3/fees/claim`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/coinvoyage/apis/coinvoyage-api-v3/docs/fees/claim/post.ts> (a function with typed inputs; its response is checked against the schema)

## Headers

- `Authorization-Signature` string, required

## Request body

- ClaimFeesRequest
  - `currency` CurrencyBase, required
    - `address` string, nullable
    - `chain_id` 1 | 10 | 56 | 137 | 4663 | 8453 | 42161 | 20000000000001 | 20000000000002 | 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 (or a no-claimable-fees message)

- ClaimFeesView
  - `claim_order_id` string, required
  - `source_transaction_hash` string, required
  - `source_chain_id` 1 | 10 | 56 | 137 | 4663 | 8453 | 42161 | 20000000000001 | 20000000000002 | 30000000000001 | 30000000000002, required
  - `currency` Amount, required
    - `ui` string, required
    - `raw` string, required: A big integer represented as a string to preserve precision
    - `value_usd` number, nullable

## Other responses

- `400`: Invalid recipient address
- `401`: Unauthorized
- `422`: Invalid request body
- `500`: Internal Server Error

## Changes

- **2026-10-13** `9b0a781499e3`: 1 warning, 1 info
  - added the new `20000000000002.00` enum value to the `source_chain_id` response property for the response status `200`
  - added the new `20000000000002.00` enum value to the request property `currency/chain_id`
- **2026-07-31** `9bac53bd1da7`: 1 warning, 1 info
  - added the new `4663.00` enum value to the `source_chain_id` response property for the response status `200`
  - added the new `4663.00` enum value to the request property `currency/chain_id`

[Operation history](https://skmtc.dev/coinvoyage/apis/coinvoyage-api-v3/changes/fees/claim/post.md)

---

[API](https://skmtc.dev/coinvoyage/apis/coinvoyage-api-v3.md) - [All operations](https://skmtc.dev/coinvoyage/apis/coinvoyage-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/coinvoyage/apis/coinvoyage-api-v3/revisions/3535f46f4c27?raw)