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

# RevShare Transactions

> Financial transactions on your RevShare campaigns. Only RevShare is covered here — CPL subscribers trigger separate settlement events, not per-transaction revenue.



## OpenAPI

````yaml api/openapi-partners.json GET /api/marketer/revshare/transactions
openapi: 3.0.2
info:
  title: OnlyTraffic Marketer API
  version: 2.0.0
  description: >-
    Partner (marketer) API for OnlyTraffic.


    **Authentication:** pass your API key in the `Authorization` header.


    **Pagination:** all list endpoints accept `offset` (default 0) and `limit`
    (default 50, max 1000) as query parameters or JSON body fields.


    **Dates:** every timestamp field has two variants — an ISO 8601 string
    (`*_at`) and a Unix timestamp integer (`*_at_ts` / `*_ts`).
servers:
  - url: https://%CURRENT_HOST%
security: []
tags:
  - name: RevShare
    description: RevShare campaigns and financial data
  - name: CPL
    description: Cost-Per-Lead orders placed against your offers
  - name: CPC
    description: Cost-Per-Click orders
  - name: Subscribers
    description: Fans acquired through your campaigns
paths:
  /api/marketer/revshare/transactions:
    get:
      tags:
        - RevShare
      summary: List RevShare transactions
      description: >-
        Financial transactions on your RevShare campaigns. Only RevShare is
        covered here — CPL subscribers trigger separate settlement events, not
        per-transaction revenue.
      parameters:
        - $ref: '#/components/parameters/offset'
        - $ref: '#/components/parameters/limit'
        - name: of_account_id
          in: query
          schema:
            type: integer
          description: Filter by OnlyFans account numeric id.
        - name: campaign_id
          in: query
          schema:
            type: string
          description: Filter by campaign public_id.
        - name: from
          in: query
          schema:
            type: string
            format: date
            example: '2024-01-01'
          description: Start date (inclusive), format Y-m-d.
        - name: to
          in: query
          schema:
            type: string
            format: date
            example: '2024-01-31'
          description: End date (inclusive), format Y-m-d.
        - name: status
          in: query
          schema:
            type: string
            enum:
              - processed
              - refunded
          description: Filter by transaction status.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                oneOf:
                  - title: Success
                    type: object
                    properties:
                      status:
                        type: string
                        enum:
                          - success
                      data:
                        type: array
                        items:
                          $ref: '#/components/schemas/RevShareTransaction'
                  - $ref: '#/components/schemas/ErrorResponse'
              example:
                status: success
                data:
                  - of_transaction_id: '9876543210'
                    of_user_id: 789
                    of_user_name: John
                    of_account_id: 456789
                    campaign_id: camp_abc123
                    amount: 10.5
                    revenue: 4.2
                    type: tip
                    status: processed
                    is_refunded: false
                    refunded_at: null
                    refunded_at_ts: null
                    date: '2024-06-01T12:00:00+00:00'
                    date_ts: 1717243200
      security:
        - api_key: []
components:
  parameters:
    offset:
      name: offset
      in: query
      schema:
        type: integer
        default: 0
        minimum: 0
      description: Number of records to skip.
    limit:
      name: limit
      in: query
      schema:
        type: integer
        default: 50
        minimum: 1
        maximum: 1000
      description: Number of records to return.
  schemas:
    RevShareTransaction:
      type: object
      properties:
        of_transaction_id:
          type: string
          description: Original OnlyFans transaction id.
        of_user_id:
          type: integer
          description: OnlyFans subscriber user id.
        of_user_name:
          type: string
          description: Subscriber display name at transaction time.
        of_account_id:
          type: integer
        campaign_id:
          type: string
        amount:
          type: number
          description: Gross transaction amount (what the subscriber paid).
        revenue:
          type: number
          description: Your share of the transaction.
        type:
          type: string
          enum:
            - subscription
            - resubscription
            - tip
            - message
            - post
            - stream
            - other
          description: OnlyFans transaction type.
        status:
          type: string
          enum:
            - processed
            - refunded
        is_refunded:
          type: boolean
        refunded_at:
          type: string
          format: date-time
          nullable: true
        refunded_at_ts:
          type: integer
          nullable: true
        date:
          type: string
          format: date-time
        date_ts:
          type: integer
    ErrorResponse:
      title: Error
      type: object
      properties:
        status:
          type: string
          enum:
            - error
        message:
          type: string
          description: Human-readable error description.
        error_code:
          type: integer
          description: '422: bad request params. 404: not found. 429: rate limit exceeded.'
  securitySchemes:
    api_key:
      type: apiKey
      name: Authorization
      in: header

````