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

# Get Customer Value Conversion Report

> Retrieve the conversions and events attributed to a single customer. Takes the same body as the [Get Conversion Report](/api-reference/post-networksreportingconversions) endpoint, plus a required `user_id`.


Returns the conversions and events attributed to one customer. This is the Customer Value view of the conversion report — Customer Value was previously called **User Management**, which is where the `usm` in the path comes from.

The body is the same as [Get Conversion Report](/api-reference/post-networksreportingconversions), with one addition: `user_id` identifies the customer and is required. An empty value returns `400 Invalid user id`.

As with the standard conversion report, at least one of `show_conversions` and `show_events` must be `true`, or the request is rejected.

A customer with no conversions in the window returns `200` with an empty `conversions` array — an unknown `user_id` is not an error.

This endpoint needs an API key with Reporting → Conversion access.


## OpenAPI

````yaml openapi/customer-value.yaml post /networks/reporting/usmconversions
openapi: 3.0.3
info:
  title: Everflow Network API - Customer Value
  description: >
    Endpoints for managing Customer Value — data points and rules — in the
    Everflow network.


    Customer Value was previously called **User Management**, and the API paths
    keep the `usm` prefix from that name.


    A **data point** declares a named customer attribute (`ltv_90d`,
    `plan_tier`) that you send in with conversions. A **rule** watches those
    data points, plus standard conversion metrics, and adjusts payout or revenue
    when a customer's aggregated values meet its goals. For setup, see [Customer
    Value](https://helpdesk.everflow.io/customer/customer-value) in the Help
    Center.
  version: 1.0.0
servers:
  - description: Production Server
    url: https://api.eflow.team/v1
security: []
tags:
  - name: Customer Value
    description: >-
      Data points and rules that drive Customer Value payout and revenue
      adjustments.
  - name: Reporting
    description: Conversion reporting scoped to a single customer.
paths:
  /networks/reporting/usmconversions:
    post:
      tags:
        - Reporting
      summary: Get Customer Value Conversion Report
      description: >
        Retrieve the conversions and events attributed to a single customer.
        Takes the same body as the [Get Conversion
        Report](/api-reference/post-networksreportingconversions) endpoint, plus
        a required `user_id`.
      parameters:
        - in: query
          name: page
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
          description: The page of results to retrieve.
        - in: query
          name: page_size
          required: false
          schema:
            type: integer
            minimum: 1
            default: 50
          description: The number of results to return per page.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UsmConversionQuery'
            example:
              user_id: cust_12345
              from: '2026-08-01'
              to: '2026-09-02'
              timezone_id: 67
              currency_id: USD
              show_conversions: true
              show_events: true
              query: {}
      responses:
        '200':
          description: >
            Conversion records for the customer. Each entry has the same shape
            as an entry in the [Get Conversion
            Report](/api-reference/post-networksreportingconversions) response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  conversions:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
        '400':
          description: >
            `user_id` was empty (`Invalid user id`), or both `show_conversions`
            and `show_events` were `false`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - API Key: []
components:
  schemas:
    UsmConversionQuery:
      type: object
      required:
        - user_id
        - from
        - to
        - timezone_id
        - currency_id
      properties:
        user_id:
          type: string
          example: cust_12345
          description: >
            The customer identifier to report on. Required — an empty value is
            rejected with `Invalid user id`.
        from:
          type: string
          description: 'Start date (format: `YYYY-MM-DD` or `YYYY-MM-DD HH:mm:SS`).'
        to:
          type: string
          description: 'End date (format: `YYYY-MM-DD` or `YYYY-MM-DD HH:mm:SS`).'
        timezone_id:
          type: integer
          description: Timezone identifier for the date range. See `/meta/timezones`.
        currency_id:
          type: string
          description: >-
            Currency code for monetary values. Currently only `USD` is
            supported.
        show_conversions:
          type: boolean
          description: >
            Include base conversion records. At least one of `show_conversions`
            and `show_events` must be `true`.
        show_events:
          type: boolean
          description: Include post-conversion event records.
        show_only_scrub:
          type: boolean
          description: Only include scrubbed (rejected) conversions and events.
        show_only_vt:
          type: boolean
          description: Only include view-through conversions.
        show_only_ct:
          type: boolean
          description: Only include click-through conversions.
        show_only_fail_traffic:
          type: boolean
          description: Only include fail traffic conversions.
        query:
          type: object
          description: >
            Filters and search terms, identical to the `query` object on [Get
            Conversion
            Report](/api-reference/post-networksreportingconversions).
          additionalProperties: true
    Error:
      type: object
      properties:
        error:
          type: string
          description: A human-readable description of what was rejected.
  securitySchemes:
    API Key:
      description: The Everflow API key generated from the Control Center > Security.
      in: header
      name: X-Eflow-Api-Key
      type: apiKey

````