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

# Get Van Westendorp aggregate results

> Returns the aggregated Van Westendorp Price Sensitivity Meter analysis for a van_westendorp question: the four cumulative respondent-price curves (Too cheap / Bargain / Expensive / Too expensive), the four named price intersections (PMC, OPP, IPP, PME), per-bucket histograms, and a confidence signal. Useful when the caller wants the analyzed price points without parsing every respondent's raw quartet themselves.

### Prerequisites
- Question must be a `van_westendorp` type
- Question must have at least one approved response
- Returns 422 for non-VW questions or questions with no approved responses yet



## OpenAPI

````yaml /docs/api-reference/openapi.json get /surveys/{id}/questions/{questionId}/van-westendorp
openapi: 3.1.0
info:
  title: PickFu API
  version: 1.0.0
  description: >-
    The PickFu API enables programmatic access to create surveys, retrieve
    results, and integrate PickFu into your workflows.


    ## Overview


    PickFu helps you get instant consumer feedback through surveys. With the
    API, you can:


    - Create surveys programmatically

    - Retrieve survey results and respondent data

    - Target specific audiences with demographic traits

    - Integrate PickFu into your product development workflow


    ## Rate Limits


    Selected endpoints (currently the CSV export endpoints) enforce per-caller
    rate limits and return `429 Too Many Requests` when exceeded. See each
    endpoint description for its specific budget.


    ## Authentication


    All API requests require a Bearer token — either an API key or an OAuth 2.0
    access token. See the [Authentication
    guide](https://www.pickfu.com/docs/developers/authentication) for details.
  contact:
    name: PickFu Support
    email: support@pickfu.com
    url: https://www.pickfu.com
servers:
  - url: https://api.pickfu.com/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Surveys
    description: >-
      Create, retrieve, update, and publish surveys. Surveys are the core
      resource — each contains one or more questions with answer options.
  - name: Responses
    description: >-
      Retrieve individual responses (answers) for a survey, with pagination and
      per-question filtering.
  - name: Tags
    description: Organize surveys with tags. Tags are scoped to your team/account.
  - name: Projects
    description: >-
      Organize surveys into projects. Projects group related surveys and can be
      bookmarked or archived.
  - name: Traits
    description: >-
      Audience targeting and reporting traits used to reach specific
      demographics and segment survey results.
  - name: Playbooks
    description: >-
      Discover and retrieve step-by-step research playbooks. Each playbook is a
      structured sequence of polls designed for a specific research goal.
  - name: Help
    description: Search the PickFu help center for articles and guides.
  - name: Media
    description: >-
      Generate images from text prompts and upload media files to the PickFu
      CDN.
  - name: Semantic Search
    description: >-
      Search completed surveys in your enrolled team account by meaning and
      answer evidence.
paths:
  /surveys/{id}/questions/{questionId}/van-westendorp:
    get:
      tags:
        - Surveys
      summary: Get Van Westendorp aggregate results
      description: >-
        Returns the aggregated Van Westendorp Price Sensitivity Meter analysis
        for a van_westendorp question: the four cumulative respondent-price
        curves (Too cheap / Bargain / Expensive / Too expensive), the four named
        price intersections (PMC, OPP, IPP, PME), per-bucket histograms, and a
        confidence signal. Useful when the caller wants the analyzed price
        points without parsing every respondent's raw quartet themselves.


        ### Prerequisites

        - Question must be a `van_westendorp` type

        - Question must have at least one approved response

        - Returns 422 for non-VW questions or questions with no approved
        responses yet
      operationId: getVanWestendorpResults
      parameters:
        - schema:
            type: string
          in: path
          name: id
          required: true
          description: Survey GUID
        - schema:
            type: string
          in: path
          name: questionId
          required: true
          description: Question GUID within the survey (must be a van_westendorp question)
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  currency:
                    type: string
                    description: ISO 4217 currency derived from the survey target country
                  priceRange:
                    type: object
                    description: >-
                      Price-axis bounds derived from respondent answers (used by
                      curves + histograms).
                    properties:
                      min:
                        type: number
                      max:
                        type: number
                      step:
                        type: number
                  curves:
                    type: object
                    description: >-
                      Cumulative respondent percentages at each price step, one
                      entry per axis price (indices align across all four curves
                      and with priceRange.min..max stepped by priceRange.step).
                    properties:
                      tooCheap:
                        type: array
                        items:
                          type: number
                      bargain:
                        type: array
                        items:
                          type: number
                      expensive:
                        type: array
                        items:
                          type: number
                      tooExpensive:
                        type: array
                        items:
                          type: number
                  intersections:
                    type: object
                    description: >-
                      Named Van Westendorp price points. Ordering invariant: PMC
                      ≤ OPP ≤ IPP ≤ PME.
                    properties:
                      PMC:
                        type: object
                        properties:
                          price:
                            type: number
                          pct:
                            type: number
                        description: >-
                          Point of Marginal Cheapness — tooCheap × expensive
                          intersection (lower bound of acceptable range)
                      OPP:
                        type: object
                        properties:
                          price:
                            type: number
                          pct:
                            type: number
                        description: >-
                          Optimal Price Point — tooCheap × tooExpensive
                          intersection
                      IPP:
                        type: object
                        properties:
                          price:
                            type: number
                          pct:
                            type: number
                        description: >-
                          Indifference Price Point — bargain × expensive
                          intersection (typical market price)
                      PME:
                        type: object
                        properties:
                          price:
                            type: number
                          pct:
                            type: number
                        description: >-
                          Point of Marginal Expensiveness — bargain ×
                          tooExpensive intersection (upper bound of acceptable
                          range)
                  nms:
                    type: array
                    items:
                      type: number
                    description: >-
                      Percentage of respondents for whom each price is within
                      their acceptable range — neither too cheap nor too
                      expensive — computed as max(0, 100 − tooCheap −
                      tooExpensive) at each price step (indices align with the
                      curves). Not the full Newton-Miller-Smith
                      purchase-probability model, which requires extra trial
                      questions this question type does not collect.
                  histograms:
                    type: object
                    description: >-
                      Per-bucket distributions of respondent prices for each of
                      the four PSM questions.
                    properties:
                      tooCheap:
                        type: array
                        items:
                          type: object
                          properties:
                            price:
                              type: number
                            count:
                              type: number
                      bargain:
                        type: array
                        items:
                          type: object
                          properties:
                            price:
                              type: number
                            count:
                              type: number
                      expensive:
                        type: array
                        items:
                          type: object
                          properties:
                            price:
                              type: number
                            count:
                              type: number
                      tooExpensive:
                        type: array
                        items:
                          type: object
                          properties:
                            price:
                              type: number
                            count:
                              type: number
                  confidence:
                    type: string
                    enum:
                      - high
                      - medium
                      - low
                    description: Quality signal based on respondent count and data spread
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
        '422':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        OAuth2 access token obtained via the authorization flow. Include in the
        Authorization header as: `Bearer {access_token}`

````

## Related topics

- [PickFu CLI for surveys and automation](https://www.pickfu.com/docs/integrations/cli.md)
- [What is a Van Westendorp price test and when to use it?](https://www.pickfu.com/help/what-is-a-van-westendorp-price-test-and-when-should-i-use-it.md)
- [How PickFu surveys work: questions, audience, results](https://www.pickfu.com/docs/guides/surveys-overview.md)
- [PickFu API v2 overview and differences from v1](https://www.pickfu.com/docs/api-reference/v2/introduction.md)
- [Get survey](https://www.pickfu.com/docs/api-reference/surveys/get-survey.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.