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

# Fetch Split Data

> Retrieve revenue split information for a smart contract

Fetch detailed information about revenue splits for a contract, including all split holders, their percentages, and identity information. Results are paginated with a maximum of 25 splits per page.


## OpenAPI

````yaml POST /v1#splits_fetch_data
openapi: 3.0.0
info:
  title: SHARE Protocol API
  description: Micropayments, revenue sharing and distribution.
  version: 1.0.0
  contact:
    name: Formless
    url: https://www.formless.xyz
servers:
  - url: https://share-ddn.formless.xyz
    description: Production server
security: []
paths:
  /v1#splits_fetch_data:
    post:
      tags:
        - Revenue Sharing
      summary: Fetch Revenue Split Data
      description: >-
        Retrieve revenue split information for a smart contract, including all
        split holders and their percentages
      operationId: splits_fetch_data
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
                - params
              properties:
                jsonrpc:
                  type: string
                  enum:
                    - '2.0'
                  default: '2.0'
                id:
                  type: string
                  default: '1'
                method:
                  type: string
                  enum:
                    - splits_fetch_data
                  default: splits_fetch_data
                params:
                  type: object
                  required:
                    - contract_address
                    - network_id
                  properties:
                    contract_address:
                      type: string
                      default: '0x1234567890abcdef1234567890abcdef12345678'
                      description: The digital property contract address
                    network_id:
                      type: integer
                      enum:
                        - 8453
                      default: 8453
                      description: Blockchain network ID (8453 for Base)
                    page:
                      type: integer
                      default: 0
                      description: Page number for pagination (starts at 0)
                    page_size:
                      type: integer
                      default: 25
                      maximum: 25
                      description: Number of splits per page (max 25)
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SplitsFetchDataResponse'
      security:
        - BearerAuth: []
components:
  schemas:
    SplitsFetchDataResponse:
      type: object
      required:
        - jsonrpc
        - id
        - result
      properties:
        jsonrpc:
          type: string
          enum:
            - '2.0'
        id:
          type: string
        result:
          oneOf:
            - $ref: '#/components/schemas/SplitsFetchDataSuccess'
            - $ref: '#/components/schemas/SplitsFetchDataError'
    SplitsFetchDataSuccess:
      type: object
      required:
        - total_slots
        - total_splits
        - community_allocation_percent
        - percent_per_slot
        - splits_data
        - pagination
      properties:
        total_slots:
          type: string
          description: Total number of slots in the revenue split contract
        total_splits:
          type: integer
          description: Total number of unique split holders
        community_allocation_percent:
          type: number
          description: Percentage of revenue allocated to community splits
        percent_per_slot:
          type: number
          description: Percentage of revenue per individual slot
        splits_data:
          type: array
          items:
            $ref: '#/components/schemas/SplitObject'
          description: Array of split holder information for the current page
        email_addresses:
          type: array
          items:
            type: string
          description: Email addresses of split holders on current page
        split_percentage_owned_by_unique_id:
          type: number
          description: Percentage owned by the requesting user's Unique ID
        pagination:
          type: object
          required:
            - total_records
            - current_page
            - total_pages
          properties:
            total_records:
              type: integer
              description: Total number of split holders
            current_page:
              type: integer
              description: Current page number
            total_pages:
              type: integer
              description: Total number of pages
            next_page:
              type: integer
              nullable: true
              description: Next page number (null if on last page)
            prev_page:
              type: integer
              nullable: true
              description: Previous page number (null if on first page)
    SplitsFetchDataError:
      type: object
      required:
        - success
        - message
      properties:
        success:
          type: boolean
          enum:
            - false
        message:
          type: string
          description: Error message
    SplitObject:
      type: object
      required:
        - wallet_address
        - percentage
      properties:
        wallet_address:
          type: string
          description: Wallet address of the split holder
        unique_id:
          type: string
          nullable: true
          description: Unique ID of the split holder
        display_name:
          type: string
          nullable: true
          description: Display name of the split holder
        email_address:
          type: string
          nullable: true
          description: Email address of the split holder
        percentage:
          type: number
          description: Percentage of revenue this holder receives
        verified_identity:
          type: boolean
          description: Whether the identity has been verified
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT token with Unique ID identification

````