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

# Get Collectors

> Retrieve collectors from the In•Process protocol. Returns a ranked list of collectors with their total collected count and spending. Supports filtering by artist and time period.

**This is a public endpoint and does not require authentication.**



## OpenAPI

````yaml GET /collectors
openapi: 3.1.0
info:
  title: In•Process API
  description: >-
    The In•Process API enables browsing and managing moments from timelines.
    Retrieve moments from a specific artist's timeline, browse the in•process
    collective timeline, or filter by collection. The API supports creating
    moments, managing collections, handling payments, and interacting with the
    In•Process protocol ecosystem.
  version: 1.0.0
servers:
  - url: https://api.inprocess.world/api
    description: Production server
security: []
paths:
  /collectors:
    get:
      tags:
        - collectors
      summary: Get Collectors
      description: >-
        Retrieve collectors from the In•Process protocol. Returns a ranked list
        of collectors with their total collected count and spending. Supports
        filtering by artist and time period.


        **This is a public endpoint and does not require authentication.**
      operationId: getCollectors
      parameters:
        - name: period
          in: query
          required: false
          schema:
            type: string
            enum:
              - day
              - week
              - month
              - all
            default: all
          description: Time period to aggregate stats over. Defaults to `all`.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
          description: Number of results per page. Defaults to `20`.
        - name: page
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
          description: Page number (1-indexed). Defaults to `1`.
        - name: artist
          in: query
          required: false
          schema:
            type: string
          description: >-
            Filter stats to collectors of moments created by this artist
            address.
        - name: sort_by
          in: query
          required: false
          schema:
            type: string
            enum:
              - collected_count
              - eth_spent
              - usdc_spent
            default: collected_count
          description: Field to sort results by. Defaults to `collected_count`.
        - name: sort_order
          in: query
          required: false
          schema:
            type: string
            enum:
              - asc
              - desc
            default: desc
          description: Sort direction. Defaults to `desc`.
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CollectorsStatsResponse'
              example:
                collectors:
                  - artist_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                    username: alice
                    wallets:
                      - address: 0xcollector
                        type: external
                    collected_count: 5
                    eth_spent: '0.01'
                    usdc_spent: '10'
                total_count: 1
                page: 1
                total_pages: 1
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    CollectorsStatsResponse:
      type: object
      required:
        - collectors
        - total_count
        - page
        - total_pages
      properties:
        collectors:
          type: array
          items:
            $ref: '#/components/schemas/CollectorStats'
          description: List of collector stats
        total_count:
          type: integer
          description: Total number of collectors matching the query
        page:
          type: integer
          description: Current page number
        total_pages:
          type: integer
          description: Total number of pages
    Error:
      type: object
      required:
        - status
        - message
      properties:
        status:
          type: string
          enum:
            - error
          description: Error status
        message:
          type: string
          description: Error message
        errors:
          type: array
          description: >-
            Optional array of field-level validation errors. Typically included
            in 400 Bad Request responses for validation errors.
          items:
            type: object
            required:
              - field
              - message
            properties:
              field:
                type: string
                description: The field name that failed validation
              message:
                type: string
                description: The validation error message for this field
    CollectorStats:
      type: object
      required:
        - artist_id
        - wallets
        - collected_count
        - eth_spent
        - usdc_spent
      properties:
        artist_id:
          type: string
          format: uuid
          description: Artist identifier.
        username:
          type: string
          nullable: true
          description: Collector's username, if set.
        wallets:
          type: array
          description: Wallet addresses associated with this collector.
          items:
            type: object
            required:
              - address
              - type
            properties:
              address:
                type: string
              type:
                type: string
        collected_count:
          type: integer
          description: Total number of moments collected
        eth_spent:
          type: string
          description: Total ETH spent collecting moments
        usdc_spent:
          type: string
          description: Total USDC spent collecting moments

````