> ## 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 a price book item > Récupérer un article spécifique d'un catalogue des prix à l'aide de ses identifiants uniques. Ce point de terminaison vous permet d'accéder à des informations détaillées sur un article particulier au sein d'un catalogue des prix spécifié, y compris ses propriétés et son statut archivé, le cas échéant. > **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/{priceBookItemId} 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/{priceBookItemId}: get: tags: - Items summary: Récupérer un article de catalogue des prix description: >- Récupérer un article spécifique d'un catalogue des prix à l'aide de ses identifiants uniques. Ce point de terminaison vous permet d'accéder à des informations détaillées sur un article particulier au sein d'un catalogue des prix spécifié, y compris ses propriétés et son statut archivé, le cas échéant. operationId: >- get-/commerce/price-books/2026-09/price-books/{priceBookId}/items/{priceBookItemId}_/commerce/price-books/2026-09-beta/price-books/{priceBookId}/items/{priceBookItemId} parameters: - name: priceBookId in: path description: L'identifiant unique du catalogue des prix contenant l'article. required: true style: simple explode: false schema: type: integer format: int64 - name: priceBookItemId in: path description: L'identifiant unique de l'article dans le catalogue des prix. required: true style: simple explode: false schema: type: integer format: int64 - name: archived in: query description: S'il faut renvoyer uniquement les résultats qui ont été archivés. required: false style: form explode: true schema: type: boolean - 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/PriceBookItemResponse' default: $ref: '#/components/responses/Error' description: '' security: [] components: schemas: 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. 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 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 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. 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. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' ````