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

# Lister tous les prix

> Récupérer tous les prix de votre espace de travail

Retourne une liste de tous les prix de votre espace de travail avec des données enrichies incluant la variante de produit, le catalogue de prix, la devise et les informations fiscales.

## Authentification

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

## Paramètres de requête

<ParamField query="limit" type="number" default="100">
  Nombre maximum de prix à retourner. Min : 1, Max : 1000.
</ParamField>

<ParamField query="offset" type="number" default="0">
  Nombre de prix à ignorer (pour la pagination).
</ParamField>

## Réponse

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

<ResponseField name="data" type="array">
  Tableau d'objets prix avec données enrichies

  <Expandable title="Objet Prix">
    <ResponseField name="id" type="uuid">
      Identifiant unique du prix
    </ResponseField>

    <ResponseField name="product_variant_id" type="uuid">
      ID de la variante de produit à laquelle ce prix s'applique
    </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 contenant ce prix
    </ResponseField>

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

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

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

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

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

    <ResponseField name="pricing_model" type="string">
      Modèle de tarification : `flat`, `volume`, `graduated`, `percent`, `cost_based` ou `none`
    </ResponseField>

    <ResponseField name="amount" type="number | null">
      Montant fixe pour le modèle de tarification forfaitaire
    </ResponseField>

    <ResponseField name="volume_tiers" type="array | null">
      Tableau d'objets de paliers de volume pour la tarification par volume
    </ResponseField>

    <ResponseField name="is_volume_grid_displayed" type="boolean">
      Indique si les paliers de volume sont affichés aux clients
    </ResponseField>

    <ResponseField name="graduated_tiers" type="array | null">
      Tableau d'objets de paliers progressifs pour la tarification progressive
    </ResponseField>

    <ResponseField name="is_graduated_grid_displayed" type="boolean">
      Indique si les paliers progressifs sont affichés aux clients
    </ResponseField>

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

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

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

    <ResponseField name="cost" type="number | null">
      Prix de revient
    </ResponseField>

    <ResponseField name="floor_price" type="number | null">
      Seuil de prix minimum
    </ResponseField>

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

    <ResponseField name="is_pay_as_you_go" type="boolean">
      Indique si la facturation à l'usage est utilisée
    </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 par défaut (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 fixe de la taxe (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 (enrichi)
    </ResponseField>

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

    <ResponseField name="engagement_type" type="string | null">
      Type d'engagement : `forever` ou `fixed_period`
    </ResponseField>

    <ResponseField name="period_duration" type="number | null">
      Durée en 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="created_at" type="timestamp">
      Horodatage de la création du prix
    </ResponseField>

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

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

<ResponseField name="total" type="number">
  Nombre total de prix dans l'espace de travail
</ResponseField>

<ResponseField name="limit" type="number">
  Nombre d'éléments retournés par page
</ResponseField>

<ResponseField name="offset" type="number">
  Nombre d'éléments ignorés
</ResponseField>

<ResponseExample>
  ```json Success Response 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"
      }
    ],
    "total": 1,
    "limit": 100,
    "offset": 0
  }
  ```

  ```json Empty Response theme={null}
  {
    "success": true,
    "data": [],
    "total": 0,
    "limit": 100,
    "offset": 0
  }
  ```

  ```json Error Response theme={null}
  {
    "success": false,
    "error": "Failed to fetch prices"
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://qwoty.app/api/prices?limit=50&offset=0" \
    -H "Authorization: Bearer qwoty_your_token"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://qwoty.app/api/prices?limit=50&offset=0', {
    headers: {
      Authorization: 'Bearer qwoty_your_token',
    },
  })

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

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

  response = requests.get(
      'https://qwoty.app/api/prices',
      params={'limit': 50, 'offset': 0},
      headers={'Authorization': 'Bearer qwoty_your_token'},
  )

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