> ## 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 > Lisez un objet identifié par « {objectId} ». « {objectId} » fait référence à l'ID d'objet interne par défaut, ou éventuellement à toute valeur de propriété unique spécifiée par le paramètre de requête « idProperty ». Contrôlez ce qui est renvoyé via le paramètre de requête « properties ». > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-09/crm-price-book-items-crm-reads-api-v2026-09.json GET /crm/objects/2026-09/{objectType}/{objectId} openapi: 3.0.1 info: title: CRM Price Book Items Crm Reads Api 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: Basic - name: Batch paths: /crm/objects/2026-09/{objectType}/{objectId}: get: tags: - Basic summary: Récupérer un article de catalogue des prix description: "Lisez un objet identifié par «\_{objectId}\_». «\_{objectId}\_» fait référence à l'ID d'objet interne par défaut, ou éventuellement à toute valeur de propriété unique spécifiée par le paramètre de requête «\_idProperty\_». Contrôlez ce qui est renvoyé via le paramètre de requête «\_properties\_»." operationId: get-/crm/objects/2026-09/{objectType}/{objectId} parameters: - name: objectId in: path description: Identifiant unique de l'objet à lire. required: true style: simple explode: false schema: type: string - name: objectType in: path description: Le type de l'objet à lire. required: true style: simple explode: false schema: type: string - name: archived in: query description: >- S'il faut renvoyer uniquement les résultats qui ont été archivés. La valeur par défaut est faux. required: false style: form explode: true schema: type: boolean default: false - name: associations in: query description: >- Une liste d'objets séparés par des virgules pour lesquels les ID associés doivent être récupérés. Si l'une des associations spécifiées n'existe pas, elle sera ignorée. required: false style: form explode: true schema: type: array items: type: string - name: idProperty in: query description: >- Le nom d'une propriété dont les valeurs sont uniques pour ce type d'objet. required: false style: form explode: true schema: type: string - name: properties in: query description: >- Une liste des propriétés séparées par des virgules à renvoyer dans la réponse. Si l'une des propriétés spécifiées n'est pas présente sur le ou les objets demandé(s), elle sera ignorée. required: false style: form explode: true schema: type: array items: type: string - name: propertiesWithHistory in: query description: >- Une liste des propriétés séparées par des virgules à retourner avec leur historique des valeurs précédentes. Si l'une des propriétés spécifiées est absente sur l'objet ou les objets demandé(s), elle sera ignorée. required: false style: form explode: true schema: type: array items: type: string responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/SimplePublicObjectWithAssociations' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - crm.objects.deals.read - oauth2: - crm.objects.subscriptions.read - oauth2: - crm.objects.services.read - oauth2: - crm.objects.tickets.sensitive.read - oauth2: - crm.objects.orders.read - oauth2: - crm.objects.listings.write - oauth2: - crm.objects.custom.read - oauth2: - crm.objects.companies.write - oauth2: - crm.objects.tasks.read - oauth2: - crm.objects.custom.sensitive.write.v2 - oauth2: - crm.objects.custom.highly_sensitive.write.v2 - oauth2: - crm.objects.companies.read - oauth2: - crm.objects.appointments.sensitive.read.v2 - oauth2: - crm.objects.contacts.highly_sensitive.read.v2 - oauth2: - crm.objects.tickets.highly_sensitive.read - oauth2: - crm.objects.companies.sensitive.read.v2 - oauth2: - crm.objects.tickets.sensitive.write - oauth2: - media_bridge.read - oauth2: - crm.objects.deals.highly_sensitive.read.v2 - oauth2: - crm.objects.contacts.highly_sensitive.write.v2 - oauth2: - crm.objects.companies.highly_sensitive.read.v2 - oauth2: - crm.objects.commercepayments.write - oauth2: - crm.objects.invoices.write - oauth2: - crm.objects.contacts.sensitive.write.v2 - oauth2: - crm.objects.calls.read - oauth2: - crm.objects.users.write - oauth2: - crm.objects.meetings.read - oauth2: - crm.objects.custom.sensitive.read.v2 - oauth2: - crm.objects.users.read - oauth2: - crm.objects.partner-services.read - oauth2: - crm.objects.orders.write - oauth2: - crm.objects.partner-services.write - oauth2: - crm.objects.appointments.write - oauth2: - crm.objects.projects.highly_sensitive.write - oauth2: - crm.objects.carts.write - oauth2: - crm.objects.tickets.highly_sensitive.write - oauth2: - crm.objects.commercepayments.read - oauth2: - crm.objects.products.write - oauth2: - crm.objects.feedback_submissions.read - oauth2: - crm.objects.services.write - oauth2: - crm.objects.subscriptions.write - oauth2: - crm.objects.deals.sensitive.write.v2 - oauth2: - crm.objects.contacts.read - oauth2: - crm.objects.appointments.sensitive.write.v2 - oauth2: - crm.objects.projects.highly_sensitive.read - oauth2: - crm.objects.invoices.read - oauth2: - crm.objects.custom.write - oauth2: - tickets.sensitive.v2 - oauth2: - crm.objects.deals.write - oauth2: - e-commerce - oauth2: - crm.objects.appointments.read - oauth2: - crm.objects.projects.read - oauth2: - crm.objects.companies.sensitive.write.v2 - oauth2: - crm.objects.companies.highly_sensitive.write.v2 - oauth2: - crm.objects.deals.highly_sensitive.write.v2 - oauth2: - crm.objects.custom.highly_sensitive.read.v2 - oauth2: - crm.objects.goals.write - oauth2: - crm.objects.projects.sensitive.read - oauth2: - crm.objects.line_items.write - oauth2: - crm.objects.contacts.write - oauth2: - crm.objects.goals.read - oauth2: - crm.objects.line_items.read - oauth2: - crm.objects.partner-clients.write - oauth2: - crm.objects.projects.write - oauth2: - crm.objects.projects.sensitive.write - oauth2: - crm.objects.deals.sensitive.read.v2 - oauth2: - crm.objects.quotes.write - oauth2: - tickets.highly_sensitive.v2 - oauth2: - crm.objects.leads.read - oauth2: - crm.objects.leads.write - oauth2: - crm.objects.carts.read - oauth2: - crm.objects.emails.read - oauth2: - crm.objects.quotes.read - oauth2: - crm.objects.courses.write - oauth2: - crm.objects.partner-clients.read - oauth2: - crm.objects.notes.read - oauth2: - crm.objects.courses.read - oauth2: - crm.objects.listings.read - oauth2: - crm.objects.contacts.sensitive.read.v2 - oauth2: - crm.objects.products.read components: schemas: SimplePublicObjectWithAssociations: required: - archived - createdAt - id - properties - updatedAt type: object properties: archived: type: boolean description: Un booléen indiquant si cet objet est archivé. archivedAt: type: string description: La date et l'heure d'archivage de cet objet, au format ISO 8601. format: date-time associations: type: object additionalProperties: $ref: '#/components/schemas/CollectionResponseAssociatedId' description: >- Une carte des types d'objets associés à leurs ID associés, représentée sous forme de collections d'ID associés. createdAt: type: string description: La date et l'heure de création de cet objet, au format ISO 8601. format: date-time id: type: string description: L'identifiant unique de cet objet. objectWriteTraceId: type: string description: Chaîne utilisée pour tracer les opérations d'écriture de cet objet. properties: type: object additionalProperties: type: string description: >- Une carte des noms de propriétés et de leurs valeurs actuelles pour l'objet. propertiesWithHistory: type: object additionalProperties: type: array items: $ref: '#/components/schemas/ValueWithTimestamp' description: >- Une carte des noms de propriétés et de leurs valeurs, incluant un historique des valeurs précédentes, représentées sous forme de tableaux de paires valeur-horodatage. updatedAt: type: string description: >- La date et l'heure de la dernière mise à jour de cet objet, au format ISO 8601. format: date-time url: type: string description: Le lien pour accéder à cet objet. warnings: type: array description: >- Un ensemble d'avertissements liés à cet objet, chacun contenant une catégorie, un message et un contexte. items: $ref: '#/components/schemas/PublicObjectWarning' description: >- Représente un objet CRM avec ses propriétés, ses horodatages et un ensemble d'ID d'objets associés regroupés par type d'association. CollectionResponseAssociatedId: required: - results type: object properties: paging: $ref: '#/components/schemas/Paging' results: type: array description: "Un tableau d'ID associés, chacun représenté par un objet «\_AssociatedId\_». Cette propriété est requise et contient la liste des associations." items: $ref: '#/components/schemas/AssociatedId' description: >- Représente une collection d'ID associés renvoyés par une requête API, y compris les détails de pagination pour naviguer dans les résultats. ValueWithTimestamp: required: - sourceType - timestamp - value type: object properties: sourceId: type: string description: Une chaîne représentant l'identifiant unique de la source. sourceLabel: type: string description: >- Une chaîne fournissant une étiquette lisible par l'être humain pour la source. sourceType: type: string description: Une chaîne indiquant le type de source d'où provient la valeur. timestamp: type: string description: >- La date et l'heure d'enregistrement de la fiche d'informations, au format ISO 8601. format: date-time updatedByUserId: type: integer description: >- Un nombre entier représentant l'ID de l'utilisateur ayant mis à jour la valeur pour la dernière fois. format: int32 value: type: string description: >- La valeur réelle enregistrée. Il s'agit d'un type de chaîne de caractères. description: Modèle de propriété qui inclut un horodatage. PublicObjectWarning: required: - category - context - message type: object properties: category: type: string description: Une chaîne indiquant la catégorie de l'avertissement. context: type: object additionalProperties: type: string description: >- Un objet fournissant un contexte supplémentaire pour l'avertissement, avec des propriétés de chaîne. message: type: string description: Chaîne contenant le message d'avertissement. description: >- Représente un message d'avertissement lié à un objet public dans HubSpot, fournissant des détails sur la nature et le contexte de l'avertissement. 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: >- Contexte de la condition d'erreur, représenté sous la forme d'un objet avec des propriétés supplémentaires qui sont des tableaux de chaînes de caractères. example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour la requête. Incluez cette valeur dans tous les rapports d'erreur ou tickets d'assistance. C'est une chaîne formatée en UUID. format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: >- Information supplémentaire sur l'erreur, fournie sous forme de tableau d'objets ErrorDetail. items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associées contenant de la documentation sur l'erreur ou les étapes de correction recommandées, représentée sous forme d'objet avec des propriétés de chaîne supplémentaires. 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 Paging: type: object properties: next: $ref: '#/components/schemas/NextPage' prev: $ref: '#/components/schemas/PreviousPage' description: >- Représente les informations de pagination pour naviguer dans une liste de résultats de l'API. Il fournit des détails sur la manière d'accéder à l'ensemble de résultats précédent ou suivant. AssociatedId: required: - id - type type: object properties: id: type: string description: >- L'identifiant unique de l'objet associé, représenté sous forme de chaîne de caractères. type: type: string description: >- Le type de l'objet associé, représenté sous forme de chaîne de caractères. example: deal_to_contact description: Contient l'ID et le type d'une association 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 chaîne. context: type: object additionalProperties: type: array items: type: string description: >- Contexte de la condition d'erreur, fourni sous forme d'objet où chaque clé est une chaîne et chaque valeur est un tableau de chaînes. Cette propriété offre des informations supplémentaires sur l'erreur. example: '{missingScopes=[scope1, scope2]}' in: type: string description: >- Le nom du champ ou du paramètre dans lequel l'erreur a été trouvée. Il s'agit d'une propriété de chaîne. message: type: string description: >- Un message lisible par l'utilisateur décrivant l'erreur, accompagné, le cas échéant, des étapes de correction. Il s'agit d'une propriété de chaîne 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 chaîne. 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. NextPage: required: - after type: object properties: after: type: string description: >- Un jeton de chaîne qui indique la position après le dernier élément de l'ensemble de résultats actuel. Il est utilisé pour récupérer la page de résultats suivante. link: type: string description: >- Une URL de chaîne qui fournit un lien direct vers la page de résultats suivante. description: >- Spécifie les informations de pagination nécessaires pour récupérer le prochain ensemble de résultats dans une réponse d'API paginée PreviousPage: required: - before type: object properties: before: type: string description: >- Un jeton de chaîne utilisé pour récupérer la page de résultats précédente. link: type: string description: Une URL de chaîne qui pointe vers la page de résultats précédente. description: >- spécifie les informations de pagination nécessaires pour récupérer l'ensemble de résultats précédent dans une réponse d'API paginée responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' securitySchemes: oauth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://app.hubspot.com/oauth/authorize tokenUrl: https://api.hubapi.com/oauth/v1/token scopes: crm.objects.appointments.read: '' crm.objects.appointments.sensitive.read.v2: '' crm.objects.appointments.sensitive.write.v2: '' crm.objects.appointments.write: '' crm.objects.calls.read: '' crm.objects.carts.read: '' crm.objects.carts.write: '' crm.objects.commercepayments.read: '' crm.objects.commercepayments.write: '' crm.objects.companies.highly_sensitive.read.v2: '' crm.objects.companies.highly_sensitive.write.v2: '' crm.objects.companies.read: '' crm.objects.companies.sensitive.read.v2: '' crm.objects.companies.sensitive.write.v2: '' crm.objects.companies.write: '' crm.objects.contacts.highly_sensitive.read.v2: '' crm.objects.contacts.highly_sensitive.write.v2: '' crm.objects.contacts.read: '' crm.objects.contacts.sensitive.read.v2: '' crm.objects.contacts.sensitive.write.v2: '' crm.objects.contacts.write: '' crm.objects.courses.read: '' crm.objects.courses.write: '' crm.objects.custom.highly_sensitive.read.v2: '' crm.objects.custom.highly_sensitive.write.v2: '' crm.objects.custom.read: '' crm.objects.custom.sensitive.read.v2: '' crm.objects.custom.sensitive.write.v2: '' crm.objects.custom.write: '' crm.objects.deals.highly_sensitive.read.v2: '' crm.objects.deals.highly_sensitive.write.v2: '' crm.objects.deals.read: '' crm.objects.deals.sensitive.read.v2: '' crm.objects.deals.sensitive.write.v2: '' crm.objects.deals.write: '' crm.objects.emails.read: '' crm.objects.feedback_submissions.read: '' crm.objects.goals.read: '' crm.objects.goals.write: '' crm.objects.invoices.read: '' crm.objects.invoices.write: '' crm.objects.leads.read: '' crm.objects.leads.write: '' crm.objects.line_items.read: '' crm.objects.line_items.write: '' crm.objects.listings.read: '' crm.objects.listings.write: '' crm.objects.meetings.read: '' crm.objects.notes.read: '' crm.objects.orders.read: '' crm.objects.orders.write: '' crm.objects.partner-clients.read: '' crm.objects.partner-clients.write: '' crm.objects.partner-services.read: '' crm.objects.partner-services.write: '' crm.objects.products.read: '' crm.objects.products.write: '' crm.objects.projects.highly_sensitive.read: '' crm.objects.projects.highly_sensitive.write: '' crm.objects.projects.read: '' crm.objects.projects.sensitive.read: '' crm.objects.projects.sensitive.write: '' crm.objects.projects.write: '' crm.objects.quotes.read: '' crm.objects.quotes.write: '' crm.objects.services.read: '' crm.objects.services.write: '' crm.objects.subscriptions.read: '' crm.objects.subscriptions.write: '' crm.objects.tasks.read: '' crm.objects.tickets.highly_sensitive.read: '' crm.objects.tickets.highly_sensitive.write: '' crm.objects.tickets.sensitive.read: '' crm.objects.tickets.sensitive.write: '' crm.objects.users.read: '' crm.objects.users.write: '' e-commerce: '' media_bridge.read: '' tickets.highly_sensitive.v2: '' tickets.sensitive.v2: '' ````