> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coinvoyage.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Claim Fees

> Claim accrued fees for the authenticated organization



## OpenAPI

````yaml https://api.coinvoyage.io/v2/openapi.json post /fees/claim
openapi: 3.1.0
info:
  title: CoinVoyage API
  description: Cryptocurrency payment processing API
  version: 2.2.0
servers:
  - url: https://api.coinvoyage.io/v2
security: []
paths:
  /fees/claim:
    post:
      tags:
        - fees
      summary: Claim Fees
      description: Claim accrued fees for the authenticated organization
      operationId: claimFees
      parameters:
        - description: >-
            Authorization header format:
            'APIKey=<api_key>,signature=<signature>,timestamp=<unix_timestamp>'
          in: header
          name: Authorization-Signature
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ClaimFeesRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/ClaimFeesResponse'
                  - properties:
                      message:
                        example: No claimable fees available
                        type: string
                    required:
                      - message
                    type: object
          description: Fees claimed successfully
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Bad Request - Invalid recipient address format for selected chain
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized - Authentication required
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unprocessable Entity - Invalid request body format
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Internal Server Error
      security:
        - Authorization: []
components:
  schemas:
    ClaimFeesRequest:
      example:
        currency:
          address: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
          chain_id: 30000000000001
        metadata:
          items:
            - currency: USD
              description: High-quality widget with extra features
              image: https://example.com/images/widget.png
              name: Premium Widget
              quantity: 2
              unit_price: 49.99
          refund:
            additional_info: Item was never shipped
            currency: USD
            name: Order Cancellation
            reason: Customer requested refund
            refund_amount: 99.98
        recipient: 0x1234...abcd
      properties:
        currency:
          $ref: '#/components/schemas/CurrencyBase'
        recipient:
          example: 0x1234...abcd
          type: string
        metadata:
          anyOf:
            - $ref: '#/components/schemas/OrderMetadata'
            - type: 'null'
      required:
        - currency
        - recipient
      type: object
    ClaimFeesResponse:
      example:
        claim_order_id: cuidjkhg3e289y74u5t6v
        currency:
          raw_amount: '2400000'
          ui_amount: 2.4
          ui_amount_display: '2.4'
          value_usd: 123.45
        source_chain_id: 1
        source_transaction_hash: 0x1234...abcd
        transaction_hash: 0x1234...abcd
      properties:
        claim_order_id:
          example: cuidjkhg3e289y74u5t6v
          type: string
        source_transaction_hash:
          example: 0x1234...abcd
          type: string
        transaction_hash:
          deprecated: true
          description: Use 'source_transaction_hash' instead
          example: 0x1234...abcd
          type: string
        source_chain_id:
          $ref: '#/components/schemas/ChainID'
          example: 1
        currency:
          $ref: '#/components/schemas/CurrencyAmount'
      required:
        - claim_order_id
        - source_transaction_hash
        - transaction_hash
        - source_chain_id
        - currency
      type: object
    ErrorResponse:
      example:
        code: 400
        error: Bad Request
        message: Invalid request parameters
      properties:
        error:
          example: Bad Request
          type: string
        message:
          example: Invalid request parameters
          type: string
        code:
          example: 400
          format: int64
          type: integer
        details:
          anyOf:
            - type: string
            - type: number
            - type: object
      required:
        - error
        - message
        - code
      type: object
    CurrencyBase:
      example:
        address: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
        chain_id: 30000000000001
      properties:
        address:
          example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
          type:
            - string
            - 'null'
        chain_id:
          $ref: '#/components/schemas/ChainID'
          example: 30000000000001
      required:
        - chain_id
      type: object
    OrderMetadata:
      example:
        items:
          - currency: USD
            description: High-quality widget with extra features
            image: https://example.com/images/widget.png
            name: Premium Widget
            quantity: 2
            unit_price: 49.99
        refund:
          additional_info: Item was never shipped
          currency: USD
          name: Order Cancellation
          reason: Customer requested refund
          refund_amount: 99.98
      properties:
        items:
          items:
            $ref: '#/components/schemas/MetadataItems'
          type: array
        refund:
          anyOf:
            - $ref: '#/components/schemas/MetadataRefund'
            - type: 'null'
      type: object
    ChainID:
      enum:
        - 1
        - 10
        - 56
        - 137
        - 8453
        - 42161
        - 20000000000001
        - 30000000000001
        - 30000000000002
      example: 1
      format: int64
      type: integer
    CurrencyAmount:
      example:
        raw_amount: '2400000'
        ui_amount: 2.4
        ui_amount_display: '2.4'
        value_usd: 123.45
      properties:
        ui_amount:
          deprecated: true
          description: >-
            Approximate numeric amount. Do not use for payment construction; use
            raw_amount for exact amounts and ui_amount_display for display.
          example: 2.4
          type: number
        ui_amount_display:
          example: '2.4'
          type: string
        raw_amount:
          $ref: '#/components/schemas/BigInt'
          example: '2400000'
        value_usd:
          example: 123.45
          type: number
      required:
        - ui_amount
        - ui_amount_display
        - raw_amount
        - value_usd
      type: object
    MetadataItems:
      example:
        currency: USD
        description: High-quality widget with extra features
        image: https://example.com/images/widget.png
        name: Premium Widget
        quantity: 2
        unit_price: 49.99
      properties:
        name:
          example: Premium Widget
          type:
            - string
            - 'null'
        description:
          example: High-quality widget with extra features
          type:
            - string
            - 'null'
        image:
          example: https://example.com/images/widget.png
          type:
            - string
            - 'null'
        quantity:
          example: 2
          type:
            - integer
            - 'null'
        unit_price:
          example: 49.99
          type:
            - number
            - 'null'
        currency:
          example: USD
          type:
            - string
            - 'null'
      type: object
    MetadataRefund:
      example:
        additional_info: Item was never shipped
        currency: USD
        name: Order Cancellation
        reason: Customer requested refund
        refund_amount: 99.98
      properties:
        name:
          example: Order Cancellation
          type:
            - string
            - 'null'
        reason:
          example: Customer requested refund
          type:
            - string
            - 'null'
        additional_info:
          example: Item was never shipped
          type:
            - string
            - 'null'
        refund_amount:
          example: 99.98
          type:
            - number
            - 'null'
        currency:
          example: USD
          type:
            - string
            - 'null'
      type: object
    BigInt:
      description: A big integer represented as a string to preserve precision
      example: '1000000000000000000'
      type: string

````