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

# Get user fee distribution history

> Get paginated history of fee distributions for authenticated user



## OpenAPI

````yaml post /get-user-fee-history
openapi: 3.0.3
info:
  title: Token Layer API
  version: 1.0.0
  description: |2-

          Token Layer is an omnichain token trading platform where users can create and trade tokens across multiple chains.

          This API provides comprehensive access to token operations, trading, earnings,
          blockchain transactions, and portfolio management.

          ## Base URL
          All endpoints are accessed via: `https://api.tokenlayer.network/{endpoint}`

          ## Authentication
          Most endpoints require authentication using an JWT token or API key passed as a Bearer token in the Authorization header.

          ## Rate Limiting
          API calls are rate limited per user. Please implement appropriate backoff strategies.
        
  contact:
    name: Token Layer API Support
    url: https://app.tokenlayer.network
servers:
  - url: https://api.tokenlayer.network/functions/v1
    description: Production server
  - url: https://api.tokenlayer.network/functions/v1
    description: Staging server
security: []
tags:
  - name: Tokens
    description: Token creation, browsing, search, trading, and price operations
  - name: Transactions
    description: Blockchain transactions (send, tip, ownership checks)
paths:
  /get-user-fee-history:
    post:
      tags:
        - Fees
      summary: Get user fee distribution history
      description: Get paginated history of fee distributions for authenticated user
      operationId: getUserFeeHistory
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                user_id:
                  type: string
                  format: uuid
                fee_type:
                  type: string
                  enum:
                    - builder
                    - token_referral
                    - ip_holder
                    - protocol_referral
                    - protocol_referral_cashback
                chains:
                  type: array
                  items:
                    type: string
                limit:
                  type: number
                  minimum: 1
                  maximum: 100
                  default: 50
                offset:
                  type: number
                  minimum: 0
                  default: 0
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  distributions:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                        recipient_address:
                          type: string
                        distribution_type:
                          type: string
                          enum:
                            - owner
                            - builder
                            - referral
                            - protocol_referral
                            - protocol_referral_cashback
                        fee_type:
                          type: string
                          enum:
                            - builder
                            - token_referral
                            - ip_holder
                            - protocol_referral
                        activity_id:
                          type: string
                          enum:
                            - bonding_curve_trade
                            - dex_trade
                            - token_creation
                            - graduation
                            - external_token_creation
                            - cross_chain_registration
                        amount:
                          type: string
                        amount_with_decimals:
                          type: string
                        decimals:
                          type: number
                          nullable: true
                        currency_address:
                          type: string
                        chain:
                          type: string
                        tracking_id:
                          type: string
                          nullable: true
                        transaction_hash:
                          type: string
                        block_number:
                          type: number
                        created_at:
                          type: string
                        token:
                          type: object
                          nullable: true
                          properties:
                            id:
                              type: string
                              format: uuid
                            name:
                              type: string
                            symbol:
                              type: string
                            slug:
                              type: string
                            logo:
                              type: string
                              nullable: true
                          required:
                            - id
                            - name
                            - symbol
                            - slug
                            - logo
                      required:
                        - id
                        - recipient_address
                        - distribution_type
                        - fee_type
                        - activity_id
                        - amount
                        - amount_with_decimals
                        - decimals
                        - currency_address
                        - chain
                        - tracking_id
                        - transaction_hash
                        - block_number
                        - created_at
                        - token
                  total_count:
                    type: number
                required:
                  - distributions
                  - total_count
        '400':
          description: Bad request - Invalid parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '401':
          description: Unauthorized - Invalid or missing authentication
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT token or API key

````