> ## 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. # List > Lire une page de transactions. Contrôlez ce qui est renvoyé via le paramètre de requête « propriétés ». > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/legacy/v3/crm-deals-v3.json GET /crm/v3/objects/0-3 openapi: 3.0.1 info: title: Transactions description: >- CRM objects such as companies, contacts, deals, line items, products, tickets, and quotes are standard objects in HubSpot’s CRM. These core building blocks support custom properties, store critical information, and play a central role in the HubSpot application. ## Supported Object Types This API provides access to collections of CRM objects, which return a map of property names to values. Each object type has its own set of default properties, which can be found by exploring the [CRM Object Properties API](https://developers.hubspot.com/docs/methods/crm-properties/crm-properties-overview). |Object Type |Properties returned by default | |--|--| | `companies` | `name`, `domain` | | `contacts` | `firstname`, `lastname`, `email` | | `deals` | `dealname`, `amount`, `closedate`, `pipeline`, `dealstage` | | `products` | `name`, `description`, `price` | | `tickets` | `content`, `hs_pipeline`, `hs_pipeline_stage`, `hs_ticket_category`, `hs_ticket_priority`, `subject` | Find a list of all properties for an object type using the [CRM Object Properties](https://developers.hubspot.com/docs/methods/crm-properties/get-properties) API. e.g. `GET https://api.hubapi.com/properties/v2/companies/properties`. Change the properties returned in the response using the `properties` array in the request body. version: v3 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE x-hubspot-api-use-case: >- Lorsqu'un représentant commercial commence à travailler avec un client potentiel, créez une fiche d'informations de transaction pour suivre le processus de négociation. Lorsque le client effectue ensuite son achat, vous pouvez actualiser la transaction à une phase fermée. x-hubspot-related-documentation: - name: Deals Guide url: https://developers.hubspot.com/docs/guides/api/crm/objects/deals x-hubspot-introduction: >- Utilisez l'API des transactions pour créer et gérer des fiches d'informations CRM qui représentent des transactions avec des contacts et/ou des entreprises. Les transactions progressent à travers les étapes du pipeline pour refléter si la transaction a été complétée, est active, ou a été perdue. servers: - url: https://api.hubapi.com security: [] tags: - name: Basic - name: Batch - name: Search paths: /crm/v3/objects/0-3: get: tags: - Basic summary: Liste description: "Lire une page de transactions. Contrôlez ce qui est renvoyé via le paramètre de requête «\_propriétés\_»." operationId: get-/crm/v3/objects/0-3_getPage parameters: - 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: 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 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: limit in: query description: Le nombre maximum de résultats à afficher par page. required: false style: form explode: true schema: type: integer format: int32 default: 10 - 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 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 - 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 n'est pas présente sur l'objet ou les objets demandé(s), elle sera ignorée. L'utilisation de ce paramètre réduira le nombre maximum d'objets pouvant être lus par une seule requête. required: false style: form explode: true schema: type: array items: type: string responses: '200': description: successful operation content: application/json: schema: $ref: >- #/components/schemas/CollectionResponseSimplePublicObjectWithAssociationsForwardPaging default: $ref: '#/components/responses/Error' description: '' security: [] components: schemas: CollectionResponseSimplePublicObjectWithAssociationsForwardPaging: required: - results type: object properties: paging: $ref: '#/components/schemas/ForwardPaging' results: type: array description: >- Un tableau d'objets publics simples inclus dans la page actuelle de la réponse. Chaque objet peut inclure ses données associées. items: $ref: '#/components/schemas/SimplePublicObjectWithAssociations' description: >- Représente une réponse de collection paginée qui inclut des objets publics simples avec leurs associations. Ce composant est utilisé pour gérer les résultats et les détails de pagination lors de la récupération d'une liste d'objets à partir de l'API. 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." SimplePublicObjectWithAssociations: required: - archived - createdAt - id - properties - updatedAt type: object properties: archived: type: boolean description: Si l'objet est archivé. archivedAt: type: string description: "L'horodatage du moment où l'objet a été archivé, au format ISO\_8601." format: date-time associations: type: object additionalProperties: $ref: '#/components/schemas/CollectionResponseAssociatedId' description: Une liste définissant les relations avec d'autres objets. createdAt: type: string description: "L'horodatage du moment où l'objet a été créé, au format ISO\_8601." format: date-time id: type: string description: L'ID unique de l'objet. objectWriteTraceId: type: string description: >- Un identifiant permettant de suivre la demande de création ou de mise à jour de l'objet. properties: type: object additionalProperties: type: string description: Paires clé-valeur représentant les propriétés de l'objet. propertiesWithHistory: type: object additionalProperties: type: array items: $ref: '#/components/schemas/ValueWithTimestamp' description: >- Paires clé-valeur représentant les propriétés de l'objet avec leur historique. updatedAt: type: string description: "L'horodatage du moment où l'objet a été mis à jour pour la dernière fois, au format ISO\_8601." format: date-time url: type: string description: Le lien pour accéder à cet objet. warnings: type: array 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. Error: required: - category - correlationId - message type: object properties: category: type: string description: La catégorie d'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'erreur example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour la demande. Incluez cette valeur dans tous les rapports d'erreurs ou tickets d'assistance format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: informations supplémentaires à propos de l'erreur items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associés contenant de la documentation sur l'erreur ou les mesures correctives recommandées message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant example: An error occurred subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur 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 curseur de pagination pour récupérer les pages suivantes. link: type: string description: >- Une URL qui peut être utilisée pour récupérer les résultats de la page 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 example: after: NTI1Cg%3D%3D link: '?after=NTI1Cg%3D%3D' CollectionResponseAssociatedId: required: - results type: object properties: paging: $ref: '#/components/schemas/Paging' results: type: array description: Une liste d'ID associés récupérés à partir de la requête API. 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: L'ID unique de la propriété. sourceLabel: type: string description: Un libellé lisible par l'homme. sourceType: type: string description: Le type de propriété. timestamp: type: string description: "Date à laquelle la propriété a été mise à jour, au format ISO\_8601." format: date-time updatedByUserId: type: integer description: >- L'ID de l'utilisateur qui a mis à jour la propriété pour la dernière fois. format: int32 value: type: string description: La valeur de la propriété. description: Modèle de propriété qui inclut un horodatage. PublicObjectWarning: required: - category - context - message type: object properties: category: type: string description: >- La classification de l'avertissement, indiquant le type ou la nature du problème. context: type: object additionalProperties: type: string description: >- Informations supplémentaires ou métadonnées concernant l'avertissement, fournissant un contexte pour la compréhension du problème. message: type: string description: >- Le texte du message d'avertissement, fournissant des informations sur le problème ou l'alerte. 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. ErrorDetail: required: - message type: object properties: code: type: string description: Le code du statut associé au détail de l'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'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. message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur 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. 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 du type d'association. type: type: string description: Le type d'association. example: deal_to_contact description: Contient l'ID et le type d'une association PreviousPage: required: - before type: object properties: before: type: string description: >- Un jeton de curseur de pagination pour récupérer les pages précédentes. link: type: string description: >- Une URL qui peut être utilisée pour récupérer les résultats des pages précédentes. 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' ````