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

# Get Pricing Configuration

> Public pricing rate card. Price = how much content of each file type × (base rate + the search-by features enabled). Returns per-modality rates, tier usage pools, and plan definitions. No authentication required.



## OpenAPI

````yaml get /v1/billing/pricing
openapi: 3.1.0
info:
  title: Mixpeek API
  description: >-
    This is the Mixpeek API, providing access to various endpoints for data
    processing and retrieval.
  termsOfService: https://mixpeek.com/terms
  contact:
    name: Mixpeek Support
    url: https://mixpeek.com/contact
    email: info@mixpeek.com
  version: '0.82'
servers:
  - url: https://api.mixpeek.com
    description: Production
security: []
paths:
  /v1/billing/pricing:
    get:
      tags:
        - Pricing
      summary: Get Pricing Configuration
      description: >-
        Public pricing rate card. Price = how much content of each file type ×
        (base rate + the search-by features enabled). Returns per-modality
        rates, tier usage pools, and plan definitions. No authentication
        required.
      operationId: get_pricing_config_v1_billing_pricing_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PricingConfigResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    PricingConfigResponse:
      properties:
        credit_rate_usd:
          type: number
          title: Credit Rate Usd
          description: USD cost per credit (e.g. 0.001 = $0.001/credit)
        managed_plans:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Managed Plans
          description: Managed Mixpeek plans (Free/Pro/Team/Enterprise)
        mvs_plans:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Mvs Plans
          description: MVS standalone plans (Free/Pro/Business/Enterprise)
        mvs_usage_rates:
          additionalProperties: true
          type: object
          title: Mvs Usage Rates
          description: MVS per-unit usage rates (storage, queries, writes)
        enterprise_defaults:
          additionalProperties: true
          type: object
          title: Enterprise Defaults
          description: Default enterprise/tenant billing parameters
        extractors:
          items:
            $ref: '#/components/schemas/ExtractorPricing'
          type: array
          title: Extractors
          description: >-
            All available extractors with their cost rates. DEPRECATED for
            display: v2 surfaces render `v2.modalities` features instead (D9 —
            extractors are internal implementation).
        pricing_model:
          type: string
          title: Pricing Model
          description: Pricing model discriminator (v2 = modality+features)
          default: v2
        currency:
          type: string
          title: Currency
          default: usd
        placeholder_rates:
          type: boolean
          title: Placeholder Rates
          description: >-
            True only pre-cutover; consumers must not render dollars while true
            (contract §5 display gate).
          default: false
        modalities:
          items: {}
          type: array
          title: Modalities
          description: >-
            Per file type (modality): its billing unit, base rate, and the
            search-by features you can add (D9: the public vocabulary — render
            these, never extractors).
        usage_pools:
          additionalProperties: true
          type: object
          title: Usage Pools
          description: Tier usage pools (dollar-denominated, natural-unit equivalents)
        storage:
          additionalProperties: true
          type: object
          title: Storage
        reads:
          additionalProperties: true
          type: object
          title: Reads
        full_res_multiplier:
          type: number
          title: Full Res Multiplier
          default: 2
      type: object
      required:
        - credit_rate_usd
        - managed_plans
        - mvs_plans
        - mvs_usage_rates
        - enterprise_defaults
        - extractors
      title: PricingConfigResponse
    ErrorResponse:
      properties:
        success:
          type: boolean
          title: Success
          description: Always false for error responses
          default: false
        status:
          type: integer
          title: Status
          description: HTTP status code for this error
        error:
          $ref: '#/components/schemas/ErrorDetail'
          description: Error details payload
      type: object
      required:
        - status
        - error
      title: ErrorResponse
      description: Error response model.
      examples:
        - error:
            details:
              id: ns_123
              resource: namespace
            message: Namespace not found
            type: NotFoundError
          status: 404
          success: false
    ExtractorPricing:
      properties:
        feature_extractor_name:
          type: string
          title: Feature Extractor Name
        description:
          type: string
          title: Description
        costs:
          anyOf:
            - $ref: '#/components/schemas/CostsInfo'
            - type: 'null'
      type: object
      required:
        - feature_extractor_name
        - description
      title: ExtractorPricing
    ErrorDetail:
      properties:
        message:
          type: string
          title: Message
          description: Human-readable error message
        type:
          type: string
          title: Type
          description: Stable error type identifier (machine-readable)
        code:
          anyOf:
            - type: string
            - type: 'null'
          title: Code
          description: >-
            Fine-grained error code for programmatic handling (e.g.,
            namespace_name_taken, feature_extractor_not_found). Present only
            when consumers may need to branch on a specific error condition.
        details:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Details
          description: >-
            Optional structured details to help debugging (validation errors,
            IDs, etc.)
      type: object
      required:
        - message
        - type
      title: ErrorDetail
      description: Error detail model.
    CostsInfo:
      properties:
        tier:
          type: integer
          maximum: 4
          minimum: 1
          title: Tier
          description: 'Cost tier (1-4): 1=SIMPLE, 2=MODERATE, 3=COMPLEX, 4=PREMIUM'
        tier_label:
          type: string
          title: Tier Label
          description: Human-readable tier label (SIMPLE, MODERATE, COMPLEX, PREMIUM)
        rates:
          items:
            $ref: '#/components/schemas/CostRate'
          type: array
          title: Rates
          description: >-
            List of cost rates for different input types this extractor
            processes
      type: object
      required:
        - tier
        - tier_label
        - rates
      title: CostsInfo
      description: >-
        Credit cost information for a feature extractor.


        Describes the pricing tier and standardized cost rates for using this
        extractor.

        Rates are defined using CostUnit types that align with extractor input
        types.
    CostRate:
      properties:
        unit:
          $ref: '#/components/schemas/CostUnit'
          description: The billing unit type
        credits_per_unit:
          type: integer
          minimum: 1
          title: Credits Per Unit
          description: Number of credits charged per unit
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
          description: Human-readable description of what this rate covers
      type: object
      required:
        - unit
        - credits_per_unit
      title: CostRate
      description: |-
        Cost rate for a specific billing unit.

        Defines how many credits are charged per unit of a specific type.

        Example:
            CostRate(
                unit=CostUnit.MINUTE,
                credits_per_unit=200,
                description="Video processing"
            )
            # Means: 200 credits per minute of video
    CostUnit:
      type: string
      enum:
        - minute
        - image
        - 1k_tokens
        - page
        - face
        - extraction
      title: CostUnit
      description: |-
        Standard billing units aligned with extractor input types.

        Each unit represents a measurable quantity that extractors process:
        - MINUTE: Video/audio duration in minutes
        - IMAGE: Per image processed
        - TOKENS_1K: Text tokens in thousands
        - PAGE: Document pages (PDF, etc.)
        - FACE: Detected faces in images/video
        - EXTRACTION: Flat per-operation cost

````