> ## 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 Arweave Uploads

> Retrieve paginated Arweave upload stats and costs.



## OpenAPI

````yaml GET /uploads
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:
  /uploads:
    get:
      summary: Get Arweave Uploads
      description: >-
        Paginated Arweave upload usage and costs. Optional `period` limits how
        far back results go (`day`, `week`, `month`, or omit / `all`). Optional
        `artist` filters by wallet (`0x` + 40 hex) or username. Results are
        ordered by `sort_by` (`usdc_cost` or `winc_cost`) and `sort_order`
        (`asc` or `desc`); default is `usdc_cost` descending.
      operationId: getArweaveUploads
      parameters:
        - name: period
          in: query
          required: false
          description: >-
            Restrict results to approximately the last day, week, or month. Omit
            or use `all` for no time limit.
          schema:
            type: string
            enum:
              - day
              - week
              - month
              - all
        - name: limit
          in: query
          required: false
          description: Page size (1 to 100). Default 20.
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
        - name: page
          in: query
          required: false
          description: 1-based page number. Defaults to 1.
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: artist
          in: query
          required: false
          description: Filter by wallet (`0x` + 40 hex) or username.
          schema:
            type: string
            minLength: 1
        - name: sort_by
          in: query
          required: false
          description: Sort by total USDC or total WinC.
          schema:
            type: string
            enum:
              - usdc_cost
              - winc_cost
            default: usdc_cost
        - name: sort_order
          in: query
          required: false
          description: '`asc` or `desc`.'
          schema:
            type: string
            enum:
              - asc
              - desc
            default: desc
      responses:
        '200':
          description: Successful response; see schema for field meanings.
          content:
            application/json:
              schema:
                type: object
                required:
                  - uploads
                  - count
                  - total_usdc_cost
                properties:
                  uploads:
                    description: >-
                      One object per artist: that artist's total WinC, total
                      USDC (string with six decimal places), and `artist`
                      (username and address).
                    type: array
                    items:
                      type: object
                      required:
                        - winc_cost
                        - usdc_cost
                        - artist
                      properties:
                        winc_cost:
                          type: string
                          description: Total WinC for that artist (string).
                        usdc_cost:
                          type: string
                          description: Total USDC for that artist, six decimal places.
                        artist:
                          type: object
                          required:
                            - username
                            - address
                          properties:
                            username:
                              type: string
                              nullable: true
                            address:
                              type: string
                  count:
                    type: integer
                    description: >-
                      Total number of artists matching the request (for
                      pagination).
                  total_usdc_cost:
                    type: number
                    description: >-
                      Sum of USDC across all matching artists (not only the
                      current page).
              example:
                uploads:
                  - winc_cost: '1234567'
                    usdc_cost: '0.002300'
                    artist:
                      username: artist_name
                      address: '0x1234567890abcdef1234567890abcdef12345678'
                count: 42
                total_usdc_cost: 0.0966
        '400':
          description: Invalid query parameters
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - errors
                properties:
                  message:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
              example:
                message: Invalid query parameters
                errors:
                  - code: too_small
                    minimum: 1
                    type: number
                    inclusive: true
                    exact: false
                    message: Number must be greater than or equal to 1
                    path:
                      - page
        '500':
          description: Error. JSON body includes `message`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                message: Failed to fetch arweave uploads
      security: []
components:
  schemas:
    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

````