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

# Get Price

> Retrieve a specific price by ID

Returns detailed information about a specific price, including all pricing configuration and enriched data.

## Authentication

<ParamField header="Authorization" type="string" required>
  Bearer token for authentication
</ParamField>

## Path Parameters

<ParamField path="id" type="uuid" required>
  The unique identifier of the price
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Indicates if the request was successful
</ResponseField>

<ResponseField name="data" type="object">
  The complete price object with all fields and enriched data

  <Expandable title="Full Price Details">
    <ResponseField name="id" type="uuid">
      Unique identifier for the price
    </ResponseField>

    <ResponseField name="product_id" type="uuid">
      ID of the product this price applies to
    </ResponseField>

    <ResponseField name="product_variant_name" type="string">
      Name of the product variant (enriched)
    </ResponseField>

    <ResponseField name="pricebook_id" type="uuid">
      ID of the pricebook
    </ResponseField>

    <ResponseField name="pricebook_name" type="string">
      Name of the pricebook (enriched)
    </ResponseField>

    <ResponseField name="pricebook_type" type="string">
      Type: `fixed` or `dynamic` (enriched)
    </ResponseField>

    <ResponseField name="currency_id" type="uuid">
      ID of the currency
    </ResponseField>

    <ResponseField name="currency_name" type="string">
      Currency name (enriched)
    </ResponseField>

    <ResponseField name="currency_api_name" type="string">
      Currency code, e.g., `EUR`, `USD` (enriched)
    </ResponseField>

    <ResponseField name="pricing_model" type="string">
      One of: `flat`, `volume`, `graduated`, `percent`, `cost_based`, `none`
    </ResponseField>

    <ResponseField name="amount" type="number | null">
      Fixed price amount (for flat model)
    </ResponseField>

    <ResponseField name="volume_tiers" type="array | null">
      Volume pricing tiers

      <Expandable title="Tier Structure">
        <ResponseField name="first_unit" type="number">
          Starting unit for this tier
        </ResponseField>

        <ResponseField name="last_unit" type="number | null">
          Ending unit (null for unlimited)
        </ResponseField>

        <ResponseField name="amount_per_unit" type="number">
          Price per unit in this tier
        </ResponseField>

        <ResponseField name="flat_fee" type="number">
          Fixed fee for this tier
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="is_volume_grid_displayed" type="boolean">
      Show volume tiers to customers
    </ResponseField>

    <ResponseField name="graduated_tiers" type="array | null">
      Graduated pricing tiers (same structure as volume\_tiers)
    </ResponseField>

    <ResponseField name="is_graduated_grid_displayed" type="boolean">
      Show graduated tiers to customers
    </ResponseField>

    <ResponseField name="percent" type="number | null">
      Percentage value (0-100) for percent-based pricing
    </ResponseField>

    <ResponseField name="price_percentage_type" type="string | null">
      Percentage scope: `all`, `product_type`, or `product`
    </ResponseField>

    <ResponseField name="cost_multiplier" type="number | null">
      Multiplier applied to cost for cost-based pricing
    </ResponseField>

    <ResponseField name="cost" type="number | null">
      Base cost price
    </ResponseField>

    <ResponseField name="floor_price" type="number | null">
      Minimum acceptable price
    </ResponseField>

    <ResponseField name="is_setup" type="boolean">
      Whether this is a one-time setup fee
    </ResponseField>

    <ResponseField name="is_pay_as_you_go" type="boolean">
      Whether this uses pay-as-you-go billing
    </ResponseField>

    <ResponseField name="default_tax_id" type="uuid | null">
      ID of default sales tax
    </ResponseField>

    <ResponseField name="default_tax_name" type="string | null">
      Tax name (enriched)
    </ResponseField>

    <ResponseField name="default_tax_rate" type="number | null">
      Tax rate percentage (enriched)
    </ResponseField>

    <ResponseField name="default_tax_amount" type="number | null">
      Fixed tax amount (enriched)
    </ResponseField>

    <ResponseField name="default_tax_is_percentage" type="boolean | null">
      Whether tax is percentage-based (enriched)
    </ResponseField>

    <ResponseField name="billing_frequency_id" type="uuid | null">
      ID of billing frequency for recurring prices
    </ResponseField>

    <ResponseField name="billing_frequency_period" type="number | null">
      Number of billing periods (enriched)
    </ResponseField>

    <ResponseField name="billing_frequency_unit" type="string | null">
      Billing period unit: `day`, `week`, `month`, `year` (enriched)
    </ResponseField>

    <ResponseField name="engagement_type" type="string | null">
      `forever` or `fixed_period`
    </ResponseField>

    <ResponseField name="period_duration" type="number | null">
      Number of periods for fixed engagements
    </ResponseField>

    <ResponseField name="parent_price_id" type="uuid | null">
      Parent price ID for dynamic pricebooks
    </ResponseField>

    <ResponseField name="identifiers" type="object">
      External system identifiers

      <Expandable title="identifiers properties">
        <ResponseField name="crm" type="string | null">
          External CRM system identifier
        </ResponseField>

        <ResponseField name="erp" type="string | null">
          External ERP system identifier
        </ResponseField>

        <ResponseField name="accounting" type="string | null">
          External accounting system identifier
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="workspace_id" type="uuid">
      Workspace this price belongs to
    </ResponseField>

    <ResponseField name="created_at" type="timestamp">
      Creation timestamp
    </ResponseField>

    <ResponseField name="updated_at" type="timestamp">
      Last update timestamp
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Success Response - Flat Pricing theme={null}
  {
    "success": true,
    "data": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "product_id": "660e8400-e29b-41d4-a716-446655440001",
      "product_variant_name": "Premium Widget",
      "pricebook_id": "880e8400-e29b-41d4-a716-446655440003",
      "pricebook_name": "Standard Pricebook",
      "pricebook_type": "fixed",
      "currency_id": "990e8400-e29b-41d4-a716-446655440004",
      "currency_name": "Euro",
      "currency_api_name": "EUR",
      "pricing_model": "flat",
      "amount": 99.99,
      "volume_tiers": null,
      "is_volume_grid_displayed": false,
      "graduated_tiers": null,
      "is_graduated_grid_displayed": false,
      "percent": null,
      "price_percentage_type": null,
      "cost_multiplier": null,
      "cost": 50.0,
      "floor_price": 80.0,
      "is_setup": false,
      "is_pay_as_you_go": false,
      "default_tax_id": "aa0e8400-e29b-41d4-a716-446655440005",
      "default_tax_name": "VAT 20%",
      "default_tax_rate": 20.0,
      "default_tax_amount": null,
      "default_tax_is_percentage": true,
      "billing_frequency_id": null,
      "billing_frequency_period": null,
      "billing_frequency_unit": null,
      "engagement_type": null,
      "period_duration": null,
      "parent_price_id": null,
      "identifiers": {
        "crm": "crm_price_001",
        "erp": "erp_price_001",
        "accounting": "acc_price_001"
      },
      "workspace_id": "cc0e8400-e29b-41d4-a716-446655440007",
      "created_at": "2024-12-21T10:30:00Z",
      "updated_at": "2024-12-21T14:45:00Z"
    }
  }
  ```

  ```json Success Response - Volume Pricing theme={null}
  {
    "success": true,
    "data": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "pricing_model": "volume",
      "amount": null,
      "volume_tiers": [
        {
          "first_unit": 1,
          "last_unit": 100,
          "amount_per_unit": 10.0,
          "flat_fee": 0
        },
        {
          "first_unit": 101,
          "last_unit": 500,
          "amount_per_unit": 8.5,
          "flat_fee": 0
        },
        {
          "first_unit": 501,
          "last_unit": null,
          "amount_per_unit": 7.0,
          "flat_fee": 0
        }
      ],
      "is_volume_grid_displayed": true,
      "currency_api_name": "EUR"
    }
  }
  ```

  ```json Error Response theme={null}
  {
    "success": false,
    "error": "Price not found"
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET https://qwoty.app/api/prices/550e8400-e29b-41d4-a716-446655440000 \
    -H "Authorization: Bearer qwoty_your_token"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://qwoty.app/api/prices/550e8400-e29b-41d4-a716-446655440000',
    {
      headers: {
        Authorization: 'Bearer qwoty_your_token',
      },
    },
  )

  const { success, data } = await response.json()
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://qwoty.app/api/prices/550e8400-e29b-41d4-a716-446655440000',
      headers={'Authorization': 'Bearer qwoty_your_token'},
  )

  data = response.json()
  ```
</RequestExample>