> ## 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.

# Obtenir un prix

> Récupérer un prix spécifique par ID

Retourne des informations détaillées sur un prix spécifique, incluant toute la configuration tarifaire et les données enrichies.

## Authentification

<ParamField header="Authorization" type="string" required>
  Jeton Bearer pour l'authentification
</ParamField>

## Paramètres de chemin

<ParamField path="id" type="uuid" required>
  L'identifiant unique du prix
</ParamField>

## Réponse

<ResponseField name="success" type="boolean">
  Indique si la requête a réussi
</ResponseField>

<ResponseField name="data" type="object">
  L'objet prix complet avec tous les champs et les données enrichies

  <Expandable title="Détails complets du prix">
    <ResponseField name="id" type="uuid">
      Identifiant unique du prix
    </ResponseField>

    <ResponseField name="product_variant_id" type="uuid">
      ID de la variante de produit
    </ResponseField>

    <ResponseField name="product_variant_name" type="string">
      Nom de la variante de produit (enrichi)
    </ResponseField>

    <ResponseField name="product_id" type="uuid">
      ID du produit parent (enrichi)
    </ResponseField>

    <ResponseField name="pricebook_id" type="uuid">
      ID du catalogue de prix
    </ResponseField>

    <ResponseField name="pricebook_name" type="string">
      Nom du catalogue de prix (enrichi)
    </ResponseField>

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

    <ResponseField name="currency_id" type="uuid">
      ID de la devise
    </ResponseField>

    <ResponseField name="currency_name" type="string">
      Nom de la devise (enrichi)
    </ResponseField>

    <ResponseField name="currency_api_name" type="string">
      Code de la devise, ex. : `EUR`, `USD` (enrichi)
    </ResponseField>

    <ResponseField name="pricing_model" type="string">
      L'un de : `flat`, `volume`, `graduated`, `percent`, `cost_based`, `none`
    </ResponseField>

    <ResponseField name="amount" type="number | null">
      Montant du prix fixe (pour le modèle flat)
    </ResponseField>

    <ResponseField name="volume_tiers" type="array | null">
      Paliers de tarification par volume

      <Expandable title="Structure des paliers">
        <ResponseField name="first_unit" type="number">
          Unité de départ pour ce palier
        </ResponseField>

        <ResponseField name="last_unit" type="number | null">
          Unité de fin (null pour illimité)
        </ResponseField>

        <ResponseField name="amount_per_unit" type="number">
          Prix par unité dans ce palier
        </ResponseField>

        <ResponseField name="flat_fee" type="number">
          Frais fixes pour ce palier
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="is_volume_grid_displayed" type="boolean">
      Afficher les paliers de volume aux clients
    </ResponseField>

    <ResponseField name="graduated_tiers" type="array | null">
      Paliers de tarification progressive (même structure que volume\_tiers)
    </ResponseField>

    <ResponseField name="is_graduated_grid_displayed" type="boolean">
      Afficher les paliers progressifs aux clients
    </ResponseField>

    <ResponseField name="percent" type="number | null">
      Valeur en pourcentage (0-100) pour la tarification basée sur un pourcentage
    </ResponseField>

    <ResponseField name="price_percentage_type" type="string | null">
      Portée du pourcentage : `all`, `product_type` ou `product`
    </ResponseField>

    <ResponseField name="cost_multiplier" type="number | null">
      Multiplicateur appliqué au coût pour la tarification basée sur le coût
    </ResponseField>

    <ResponseField name="cost" type="number | null">
      Prix de coût de base
    </ResponseField>

    <ResponseField name="floor_price" type="number | null">
      Prix minimum acceptable
    </ResponseField>

    <ResponseField name="is_setup" type="boolean">
      Indique s'il s'agit de frais d'installation uniques
    </ResponseField>

    <ResponseField name="is_pay_as_you_go" type="boolean">
      Indique si ce prix utilise la facturation à l'usage
    </ResponseField>

    <ResponseField name="default_tax_id" type="uuid | null">
      ID de la taxe de vente par défaut
    </ResponseField>

    <ResponseField name="default_tax_name" type="string | null">
      Nom de la taxe (enrichi)
    </ResponseField>

    <ResponseField name="default_tax_rate" type="number | null">
      Taux de taxe en pourcentage (enrichi)
    </ResponseField>

    <ResponseField name="default_tax_amount" type="number | null">
      Montant de taxe fixe (enrichi)
    </ResponseField>

    <ResponseField name="default_tax_is_percentage" type="boolean | null">
      Indique si la taxe est basée sur un pourcentage (enrichi)
    </ResponseField>

    <ResponseField name="billing_frequency_id" type="uuid | null">
      ID de la fréquence de facturation pour les prix récurrents
    </ResponseField>

    <ResponseField name="billing_frequency_period" type="number | null">
      Nombre de périodes de facturation (enrichi)
    </ResponseField>

    <ResponseField name="billing_frequency_unit" type="string | null">
      Unité de période de facturation : `day`, `week`, `month`, `year` (enrichi)
    </ResponseField>

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

    <ResponseField name="period_duration" type="number | null">
      Nombre de périodes pour les engagements fixes
    </ResponseField>

    <ResponseField name="parent_price_id" type="uuid | null">
      ID du prix parent pour les catalogues de prix dynamiques
    </ResponseField>

    <ResponseField name="identifiers" type="object">
      Identifiants des systèmes externes

      <Expandable title="propriétés des identifiants">
        <ResponseField name="crm" type="string | null">
          Identifiant du système CRM externe
        </ResponseField>

        <ResponseField name="erp" type="string | null">
          Identifiant du système ERP externe
        </ResponseField>

        <ResponseField name="accounting" type="string | null">
          Identifiant du système comptable externe
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="workspace_id" type="uuid">
      Espace de travail auquel appartient ce prix
    </ResponseField>

    <ResponseField name="created_at" type="timestamp">
      Horodatage de création
    </ResponseField>

    <ResponseField name="updated_at" type="timestamp">
      Horodatage de la dernière mise à jour
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Success Response - Flat Pricing theme={null}
  {
    "success": true,
    "data": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "product_variant_id": "660e8400-e29b-41d4-a716-446655440001",
      "product_variant_name": "Premium Widget",
      "product_id": "770e8400-e29b-41d4-a716-446655440002",
      "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>