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

# Get product pricing

> Returns pricing entries for a single product. Most products return standard rate entries with fields like rate, unit, country_iso, direction, and tiers. Inference products return model-specific fields (model, input_rate, output_rate, cached_input_rate) with tiered pricing. Some products use rate decks (pricing_type: rate_deck) where rates are determined dynamically.



## OpenAPI

````yaml /openapi/generated/account-billing/pricing.yml get /pricing/products/{slug}
openapi: 3.1.0
info:
  contact:
    email: support@telnyx.com
  description: Browse the Telnyx product catalog and retrieve product pricing.
  title: Telnyx Pricing API
  version: 2.0.0
servers:
  - url: https://api.telnyx.com/v2
security:
  - bearerAuth: []
paths:
  /pricing/products/{slug}:
    get:
      tags:
        - Pricing
      summary: Get product pricing
      description: >-
        Returns pricing entries for a single product. Most products return
        standard rate entries with fields like rate, unit, country_iso,
        direction, and tiers. Inference products return model-specific fields
        (model, input_rate, output_rate, cached_input_rate) with tiered pricing.
        Some products use rate decks (pricing_type: rate_deck) where rates are
        determined dynamically.
      operationId: getProductPricing
      parameters:
        - name: slug
          in: path
          description: Product slug from the catalog listing.
          required: true
          schema:
            type: string
        - name: page_number
          in: query
          description: Page number (1-based).
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: page_size
          in: query
          description: Number of items per page (max 100).
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 25
      responses:
        '200':
          description: Product pricing entries
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PricingEntryListResponse'
        '404':
          description: Product not found
      security: []
      x-codeSamples:
        - lang: JavaScript
          source: >-
            import Telnyx from 'telnyx';


            const client = new Telnyx({
              apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
            });


            const PricingEntryList = await
            client.pricing.products.retrieve('slug');


            console.log(PricingEntryList.data);
        - lang: Python
          source: |-
            import os
            from telnyx import Telnyx

            client = Telnyx(
                api_key=os.environ.get("TELNYX_API_KEY"),  # This is the default and can be omitted
            )
            pricing_entry_list = client.pricing.products.retrieve(
                "slug",
            )
            print(pricing_entry_list.data)
        - lang: Go
          source: "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/team-telnyx/telnyx-go\"\n\t\"github.com/team-telnyx/telnyx-go/option\"\n)\n\nfunc main() {\n\tclient := telnyx.NewClient(\n\t\toption.WithAPIKey(\"My API Key\"),\n\t)\n\tproduct, err := client.Pricing.Products.Get(\n\t\tcontext.TODO(),\n\t\t\"slug\",\n\t)\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", product.Data)\n}\n"
        - lang: Java
          source: |-
            package com.telnyx.sdk.example;

            import com.telnyx.sdk.client.TelnyxClient;
            import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;

            public final class Main {
                private Main() {}

                public static void main(String[] args) {
                    TelnyxClient client = TelnyxOkHttpClient.fromEnv();

                    var response = client.pricing().products().retrieve("slug");
                }
            }
        - lang: Ruby
          source: |-
            require "telnyx"

            telnyx = Telnyx::Client.new(api_key: "My API Key")

            pricing_entry_list = telnyx.pricing.products.retrieve("slug")

            puts(pricing_entry_list)
        - lang: PHP
          source: >-
            <?php


            require_once dirname(__DIR__) . '/vendor/autoload.php';


            use Telnyx\Client;

            use Telnyx\Core\Exceptions\APIException;


            $client = new Client(apiKey: getenv('TELNYX_API_KEY') ?: 'My API
            Key');


            try {
              $pricing_entry_list = $client->pricing->products->retrieve(
                'slug',
              );

              var_dump($pricing_entry_list);
            } catch (APIException $e) {
              echo $e->getMessage();
            }
        - lang: CLI
          source: |-
            telnyx pricing:products retrieve \
              --api-key 'My API Key' \
              --slug slug
components:
  schemas:
    PricingEntryListResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/PricingEntry'
        meta:
          $ref: '#/components/schemas/pricing_PaginationMeta'
      required:
        - data
        - meta
    PricingEntry:
      type: object
      description: >-
        A single pricing entry. Standard products include rate, unit, currency,
        type, country_iso, direction, and tiers. Inference products include
        model, input_rate, output_rate, cached_input_rate, and their respective
        tier arrays. Rate-deck products include pricing_type and note fields
        with null rate and empty tiers.
      properties:
        name:
          type: string
          description: Human-readable name describing the pricing entry.
        rate:
          oneOf:
            - type: number
              description: Rate for standard products (e.g., 0.004).
            - type: string
              description: Rate for inference products (e.g., "0.001").
            - type: 'null'
          description: >-
            Per-unit rate. Numeric for standard products, string for inference
            products. Null for rate-deck products.
        unit:
          type: string
          description: Unit of measurement (e.g., part, message, GB, per_1k_tokens).
        currency:
          type: string
          description: ISO currency code (e.g., USD).
        type:
          type: string
          description: Pricing type (e.g., usage).
        country_iso:
          type:
            - string
            - 'null'
          description: ISO country code. Null for non-geographic products.
        direction:
          type:
            - string
            - 'null'
          description: Direction (e.g., termination). Null for non-directional products.
        tiers:
          type: array
          items:
            $ref: '#/components/schemas/PricingTier'
          description: Volume-based tiered pricing. Empty for rate-deck products.
        pricing_type:
          type:
            - string
            - 'null'
          description: >-
            Pricing type for non-standard products (e.g., rate_deck). Absent on
            standard products.
        note:
          type:
            - string
            - 'null'
          description: >-
            Additional note for rate-deck products (e.g., "Pricing is determined
            by the WhatsApp rate deck.").
        model:
          type: string
          description: Model identifier. Present only on inference product entries.
        input_rate:
          type: string
          description: Input token rate. Present only on inference product entries.
        cached_input_rate:
          type: string
          description: Cached input token rate. Present only on inference product entries.
        output_rate:
          type: string
          description: Output token rate. Present only on inference product entries.
        input_tiers:
          type: array
          items:
            $ref: '#/components/schemas/PricingTier'
          description: >-
            Input token tiered pricing. Present only on inference product
            entries.
        cached_input_tiers:
          type: array
          items:
            $ref: '#/components/schemas/PricingTier'
          description: >-
            Cached input token tiered pricing. Present only on inference product
            entries.
        output_tiers:
          type: array
          items:
            $ref: '#/components/schemas/PricingTier'
          description: >-
            Output token tiered pricing. Present only on inference product
            entries.
    pricing_PaginationMeta:
      type: object
      properties:
        page_number:
          type: integer
        page_size:
          type: integer
        total_pages:
          type: integer
        total_results:
          type: integer
      required:
        - page_number
        - page_size
        - total_pages
        - total_results
    PricingTier:
      type: object
      properties:
        min:
          type: integer
          minimum: 0
          description: Lower bound of the tier (inclusive).
        max:
          type:
            - integer
            - 'null'
          description: Upper bound of the tier (exclusive). Null means no upper limit.
        rate:
          oneOf:
            - type: number
            - type: string
          description: >-
            Rate for this tier. Numeric for standard products, string for
            inference products.
      required:
        - min
        - max
        - rate
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````