> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.fr/docs/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve price book items > Récupérer une liste d'articles associés à un catalogue des prix spécifique dans votre compte HubSpot. Ce point de terminaison vous permet de paginer les articles et de spécifier les propriétés à inclure dans la réponse. Il est utile pour gérer et consulter les détails des produits liés à un catalogue des prix particulier. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-09/commerce-price-books-v2026-09.json GET /commerce/price-books/2026-09/price-books/{priceBookId}/items openapi: 3.0.1 info: title: Commerce Price Books description: Basepom for all HubSpot Projects version: 2026-09 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE servers: - url: https://api.hubapi.com security: [] tags: - name: Advanced - name: Basic - name: Batch - name: Items paths: /commerce/price-books/2026-09/price-books/{priceBookId}/items: get: tags: - Items summary: Lister les éléments du catalogue des prix description: >- Récupérer une liste d'articles associés à un catalogue des prix spécifique dans votre compte HubSpot. Ce point de terminaison vous permet de paginer les articles et de spécifier les propriétés à inclure dans la réponse. Il est utile pour gérer et consulter les détails des produits liés à un catalogue des prix particulier. operationId: >- get-/commerce/price-books/2026-09/price-books/{priceBookId}/items_/commerce/price-books/2026-09-beta/price-books/{priceBookId}/items parameters: - name: priceBookId in: path description: >- L'identifiant unique du catalogue des prix pour lequel récupérer les articles. required: true style: simple explode: false schema: type: integer format: int64 - name: after in: query description: >- Le jeton de curseur de pagination de la dernière ressource lue avec succès sera renvoyé en tant que propriété JSON `paging.next.after` d'une réponse paginée contenant plus de résultats. required: false style: form explode: true schema: type: string - name: limit in: query description: Le nombre maximum de résultats à afficher par page. required: false style: form explode: true schema: type: integer format: int32 - name: properties in: query description: Une liste de noms de propriétés à inclure dans la réponse. required: false style: form explode: true schema: type: array items: type: string responses: '200': description: successful operation content: application/json: schema: $ref: >- #/components/schemas/CollectionResponsePriceBookItemResponseForwardPaging default: $ref: '#/components/responses/Error' description: '' security: [] components: schemas: CollectionResponsePriceBookItemResponseForwardPaging: required: - results type: object properties: paging: $ref: '#/components/schemas/ForwardPaging' results: type: array description: >- Un tableau d'éléments de catalogue des prix, chacun représenté par un objet PriceBookItemResponse. items: $ref: '#/components/schemas/PriceBookItemResponse' ForwardPaging: type: object properties: next: $ref: '#/components/schemas/NextPage' description: "Informations de pagination pour une pagination unidirectionnelle. Contient la référence de la page suivante lorsque d'autres résultats sont disponibles\_; omis ou vide sur la dernière page." PriceBookItemResponse: required: - customProperties - id - productId type: object properties: archived: type: boolean description: Un booléen indiquant si l'élément du catalogue de prix est archivé. archivedAt: type: string description: >- La date et l'heure d'archivage de l'élément du catalogue des prix, au format ISO 8601. format: date-time billingFrequency: type: string description: "La fréquence de facturation de l’élément du catalogue des prix. Les valeurs valides incluent : «\_annuellement\_», «\_toutes les deux semaines\_», «\_mensuellement\_», «\_une seule fois\_», «\_tous les cinq ans\_», «\_tous les quatre ans\_», «\_tous les six mois\_», «\_tous les trois ans\_», «\_tous les deux ans\_», «\_trimestriellement\_» et «\_hebdomadairement\_»." enum: - ANNUALLY - BIWEEKLY - MONTHLY - PER_FIVE_YEARS - PER_FOUR_YEARS - PER_SIX_MONTHS - PER_THREE_YEARS - PER_TWO_YEARS - QUARTERLY - WEEKLY billingPeriod: type: string description: La période de facturation pour l'élément du catalogue des prix. costOfGoodsSold: type: string description: >- Le coût des marchandises vendues pour l'article du catalogue des prix. createdAt: type: string description: >- La date et l'heure de création de l'article du catalogue des prix, au format ISO 8601. format: date-time customProperties: type: object additionalProperties: type: string description: >- Mappage des noms de propriétés personnalisées à leurs valeurs pour l'article du catalogue des prix. description: type: string description: Description de l'article du catalogue des prix. id: type: string description: L'identifiant unique de l'article du catalogue des prix. images: type: string description: >- Une chaîne représentant les images associées à l'article du catalogue des prix. name: type: string description: Le nom de l'article du catalogue des prix. priceBookId: type: string description: L'identifiant unique du catalogue des prix contenant cet article. pricing: $ref: '#/components/schemas/Pricing' productClassification: type: string description: "La classification du produit. Les valeurs valides incluent «\_OFFRE GROUPÉE\_», «\_STANDALONE\_» et «\_VARIANT\_»." enum: - BUNDLE - STANDALONE - VARIANT productId: type: string description: >- L'identifiant unique du produit associé à l'article du catalogue des prix. productType: type: string description: "Le type de produit. Les valeurs valides incluent «\_INVENTORY\_», «\_NON_INVENTORY\_» et «\_SERVICE\_»." enum: - INVENTORY - NON_INVENTORY - SERVICE recurringBillingTerms: type: string description: "Les conditions de facturation récurrente pour l'article du catalogue des prix. Les valeurs valides incluent «\_AUTOMATICALLY_RENEW\_» et «\_FIXED\_»." enum: - AUTOMATICALLY_RENEW - FIXED sku: type: string description: >- Le numéro d'unité de gestion des stocks (UGS) de l'article du catalogue des prix. status: type: string description: "Le statut actuel de l'article du catalogue des prix. Les valeurs valides incluent «\_actif »\_ et «\_inactif\_»." enum: - active - inactive taxCategory: type: string description: La catégorie fiscale de l'article du catalogue des prix. updatedAt: type: string description: >- La date et l'heure de la dernière mise à jour de l'article du catalogue des prix, au format ISO 8601. format: date-time url: type: string description: Une URL associée à l'article du catalogue des prix. Error: required: - category - correlationId - message type: object properties: category: type: string description: >- La catégorie d'erreur, représentée sous forme de chaine de caractères. context: type: object additionalProperties: type: array items: type: string description: >- Un objet fournissant un contexte sur la condition d'erreur. Il contient des propriétés supplémentaires, chacune étant un tableau de chaînes de caractères. example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour la requête, représenté par une chaîne UUID. Incluez cette valeur dans tous les rapports d'erreur ou tickets d'assistance. format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: >- Un tableau fournissant des informations supplémentaires sur l'erreur, chaque élément étant un objet ErrorDetail. items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Un objet qui mappe les noms de liens aux URI associées contenant la documentation sur l'erreur ou les étapes de correction recommandées. Chaque propriété est une chaîne de caractères. message: type: string description: >- Un message lisible par l'utilisateur décrivant l'erreur ainsi que les mesures correctives à prendre, le cas échéant. Il s'agit d'une chaîne de caractères. example: An error occurred subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur, représentée sous forme de chaîne de caractères. description: >- Représente une réponse d'erreur renvoyée par l'API lorsqu'une opération échoue. Ce composant est utilisé dans divers points de terminaison pour fournir des informations détaillées sur l'erreur rencontrée. example: message: Invalid input (details will vary based on the error) correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf category: VALIDATION_ERROR links: knowledge-base: https://www.hubspot.com/products/service/knowledge-base NextPage: required: - after type: object properties: after: type: string description: >- Un jeton de chaîne utilisé comme curseur pour la pagination afin de récupérer l’ensemble de résultats suivant. link: type: string description: >- Une URL de chaîne qui fournit un lien direct vers la page de résultats suivante. description: >- Specifies the paging information needed to retrieve the next set of results in a paginated API response Pricing: required: - prices - pricingModel type: object properties: prices: type: array description: >- Un tableau d'entrées de prix, chacune détaillant le montant et la devise pour un niveau de tarification spécifique. items: $ref: '#/components/schemas/PriceEntry' pricingModel: type: string description: "Le type de modèle d\_e tarification appliqué, qui peut être l'un des suivants\_: «\_FORFAITAIRE\_», «\_DÉGRESSIF\_», «\_PAR PALIERS\_» ou «\_AU VOLUME\_»." enum: - FLAT - GRADUATED - STAIRSTEP - VOLUME ErrorDetail: required: - message type: object properties: code: type: string description: >- Le code de statut associé au détail de l'erreur. Il s'agit d'une propriété de type chaîne de caractères. context: type: object additionalProperties: type: array items: type: string description: >- Contexte de la condition d'erreur, qui peut inclure des informations supplémentaires telles que des portées manquantes ou des noms de propriétés non valides. example: '{missingScopes=[scope1, scope2]}' in: type: string description: >- Le nom du champ ou du paramètre dans lequel l'erreur a été détectée. Il s'agit d'une propriété de type chaîne de caractères. message: type: string description: >- Un message lisible par l'utilisateur décrivant l'erreur ainsi que les mesures correctives à prendre, le cas échéant. Cette propriété est obligatoire. subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur. Il s'agit d'une propriété de type chaîne de caractères. description: >- Représente des informations détaillées sur une erreur survenue dans l'API. Ce composant est utilisé pour fournir un contexte et des spécificités supplémentaires sur les erreurs, généralement dans le cadre d'une réponse d'erreur. PriceEntry: required: - currencyCode - price type: object properties: currencyCode: type: string description: Une chaîne représentant la devise dans laquelle le prix est exprimé. maxQuantity: type: integer description: >- Une chaîne spécifiant la quantité maximale pour laquelle cette entrée de prix est applicable. format: int32 price: type: number description: Un nombre indiquant le prix du produit ou du service. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' ````