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

# List price points with admin fields

> Retrieve all Price Points with the fields the support tools edit.

Requires an admin key. Unlike the public `/price_points` endpoint, the response also includes the internal fields `pp_id`, `pp_version`, `descriptor`, `description`, `apple_pay_merchant_name`, `pp_extra_metadata`, `created_at`, and `updated_at`. The same optional filters apply (`ident`, `currency_code`, `feature_ident`) — pass an empty object `{}` to retrieve all Price Points.


## OpenAPI

````yaml /swagger/openapi-billing.json post /pp/list
openapi: 3.0.0
info:
  title: OpenAPI3
  version: 1.0.0
servers:
  - url: https://billing.funnelfox.com/{org_id}/v1
    description: FunnelFox Payments API
    variables:
      org_id:
        default: your-org-id
        description: Your organization ID
security:
  - FunnelFoxSecretKey: []
paths:
  /pp/list:
    post:
      tags:
        - PricePoints
      summary: List price points with admin fields
      description: Retrieve all Price Points with the fields the support tools edit.
      parameters:
        - name: org_id
          in: path
          required: true
          description: Organization ID
          schema:
            type: string
          style: simple
          explode: false
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FilterPointIn'
      responses:
        '200':
          description: List of price points with admin fields
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PricePointAdminListOut'
components:
  schemas:
    FilterPointIn:
      properties:
        ident:
          type: string
          nullable: true
          description: >-
            Filter by Price Point ident, the unique identifier you assigned when
            creating the Price Point.
        currency_code:
          type: string
          nullable: true
          description: Filter by currency code.
        feature_ident:
          type: string
          nullable: true
          description: >-
            Filter by feature ident (returns price points that include this
            feature).
      title: FilterPointIn
      type: object
    PricePointAdminListOut:
      properties:
        price_points:
          items:
            $ref: '#/components/schemas/PricePointAdminOut'
          title: Price Points
          type: array
      required:
        - price_points
      title: PricePointAdminListOut
      type: object
    PricePointAdminOut:
      description: >-
        Price point as the support tools show it: everything PricePointOut hides
        from the public API.
      properties:
        ident:
          title: Ident
          type: string
        currency:
          $ref: '#/components/schemas/CurrencyOut'
        intro_type:
          $ref: '#/components/schemas/IntroTypeEnum'
        lifetime_price:
          anyOf:
            - type: number
            - type: string
          default: null
          title: Lifetime Price
          nullable: true
        intro_free_trial_period:
          type: integer
          nullable: true
        intro_free_trial_period_duration:
          anyOf:
            - $ref: '#/components/schemas/DurationEnum'
          default: null
          nullable: true
        intro_paid_trial_price:
          anyOf:
            - type: number
            - type: string
          default: null
          title: Intro Paid Trial Price
          nullable: true
        intro_paid_trial_period:
          type: integer
          nullable: true
        intro_paid_trial_period_duration:
          anyOf:
            - $ref: '#/components/schemas/DurationEnum'
          default: null
          nullable: true
        next_price:
          anyOf:
            - type: number
            - type: string
          default: null
          title: Next Price
          nullable: true
        next_period:
          type: integer
          nullable: true
        next_period_duration:
          anyOf:
            - $ref: '#/components/schemas/DurationEnum'
          default: null
          nullable: true
        features:
          description: Premium features included in this price point
          items:
            $ref: '#/components/schemas/FeatureOut'
          title: Features
          type: array
        pp_id:
          title: Pp Id
          type: integer
        pp_version:
          title: Pp Version
          type: integer
        descriptor:
          default: null
          title: Descriptor
          type: string
          nullable: true
        description:
          default: null
          title: Description
          type: string
          nullable: true
        apple_pay_merchant_name:
          default: null
          title: Apple Pay Merchant Name
          type: string
          nullable: true
        pp_extra_metadata:
          additionalProperties: true
          title: Pp Extra Metadata
          type: object
        created_at:
          format: date-time
          title: Created At
          type: string
        updated_at:
          format: date-time
          title: Updated At
          type: string
      required:
        - ident
        - currency
        - intro_type
        - features
        - pp_id
        - pp_version
        - created_at
        - updated_at
      title: PricePointAdminOut
      type: object
    CurrencyOut:
      properties:
        code:
          title: Code
          type: string
        minor_units:
          title: Minor Units
          type: integer
        title:
          title: Title
          type: string
        symbol:
          title: Symbol
          type: string
      required:
        - code
        - minor_units
        - title
        - symbol
      title: CurrencyOut
      type: object
    IntroTypeEnum:
      enum:
        - no_intro
        - free_trial
        - paid_trial
      title: IntroTypeEnum
      type: string
    DurationEnum:
      enum:
        - minutes
        - days
        - weeks
        - months
        - years
      title: DurationEnum
      type: string
    FeatureOut:
      properties:
        ident:
          title: Ident
          type: string
      required:
        - ident
      title: FeatureOut
      type: object
  securitySchemes:
    FunnelFoxSecretKey:
      type: apiKey
      in: header
      name: ff-secret-key
      description: Secret key for FunnelFox Payments API. Required for all requests.

````