> ## 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 courses > Récupérer les fiches d'informations par leur ID ou inclure le paramètre « idProperty » pour récupérer les fiches d'informations par une propriété de valeur unique personnalisée. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-03/crm-courses-v2026-03.json POST /crm/objects/2026-03/0-410/batch/read openapi: 3.0.1 info: title: Formations description: Basepom for all HubSpot Projects version: 2026-03 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE x-hubspot-introduction: >- Utilisez l’API des formations pour créer et gérer des fiches d'informations CRM représentant des informations sur un programme structuré ou une série de leçons, formations ou modules éducatifs. Identifiez le type d’objet formation grâce à son ID de type d’objet 0-410 servers: - url: https://api.hubapi.com security: [] tags: - name: Advanced - name: Basic - name: Batch - name: Search paths: /crm/objects/2026-03/0-410/batch/read: post: tags: - Batch summary: Récupérer les cours en lot description: "Récupérer les fiches d'informations par leur ID ou inclure le paramètre «\_idProperty\_» pour récupérer les fiches d'informations par une propriété de valeur unique personnalisée. " operationId: post-/crm/objects/2026-03/0-410/batch/read parameters: - 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 requestBody: content: application/json: schema: $ref: '#/components/schemas/BatchReadInputSimplePublicObjectId' required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/BatchResponseSimplePublicObject' '207': description: multiple statuses content: application/json: schema: $ref: '#/components/schemas/BatchResponseSimplePublicObjectWithErrors' default: $ref: '#/components/responses/Error' description: '' security: [] components: schemas: BatchReadInputSimplePublicObjectId: required: - inputs - properties - propertiesWithHistory type: object properties: idProperty: type: string description: >- Une chaîne représentant le nom d'une propriété dont les valeurs sont uniques pour ce type d'objet. inputs: type: array description: >- Un tableau d'objets SimplePublicObjectId, chacun représentant un ID d'objet pour lequel l'opération de lecture par lots sera effectuée. items: $ref: '#/components/schemas/SimplePublicObjectId' properties: type: array description: >- Un tableau de chaînes de caractères spécifiant les propriétés à renvoyer dans la réponse. Si les propriétés spécifiées ne sont pas présentes sur les objets demandés, elles seront ignorées. items: type: string propertiesWithHistory: type: array description: >- Un tableau de chaînes de caractères spécifiant les propriétés à renvoyer avec l'historique de leurs valeurs précédentes. Si les propriétés spécifiées ne sont pas présentes sur les objets demandés, elles seront ignorées. items: type: string description: >- Spécifie l'entrée pour la lecture d'un lot d'objets CRM, y compris des tableaux d'ID d'objets, les noms de propriétés demandés (avec historique facultatif) et une propriété d'identification unique facultative. BatchResponseSimplePublicObject: required: - completedAt - results - startedAt - status type: object properties: completedAt: type: string description: >- La date et l'heure auxquelles l'opération de lot a été effectuée, au format ISO 8601. format: date-time links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associées, fournissant des ressources ou des informations supplémentaires liées à l'opération de lot. requestedAt: type: string description: >- La date et l'heure auxquelles l'opération de lot a été demandée, au format ISO 8601. format: date-time results: type: array description: >- Un tableau d'éléments SimplePublicObject représentant les résultats de l'opération par lot. items: $ref: '#/components/schemas/SimplePublicObject' startedAt: type: string description: >- La date et l'heure de début de l'opération par lot, au format ISO 8601. format: date-time status: type: string description: "Le statut actuel de l'opération par lot. Les valeurs valides incluent «\_PENDING\_», «\_PROCESSING\_», «\_CANCELED\_» et «\_COMPLETE\_»." enum: - CANCELED - COMPLETE - PENDING - PROCESSING description: Objet de réponse de lot d'objet public BatchResponseSimplePublicObjectWithErrors: required: - completedAt - results - startedAt - status type: object properties: completedAt: type: string description: >- La date et l'heure auxquelles l'opération de lot a été effectuée, au format ISO 8601. format: date-time errors: type: array description: >- Un tableau d'objets StandardError détaillant les erreurs survenues pendant l'opération par lot. items: $ref: '#/components/schemas/StandardError' links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associées fournissant des informations supplémentaires sur l'opération de lot. numErrors: type: integer description: Le nombre d'erreurs rencontrées pendant l'opération par lot. format: int32 requestedAt: type: string description: >- La date et l'heure auxquelles l'opération de lot a été demandée, au format ISO 8601. format: date-time results: type: array description: >- Un tableau d'éléments SimplePublicObject représentant les résultats de l'opération par lot. items: $ref: '#/components/schemas/SimplePublicObject' startedAt: type: string description: >- La date et l'heure de début de l'opération par lot, au format ISO 8601. format: date-time status: type: string description: "Le statut actuel de l'opération par lot. Les valeurs valides incluent «\_PENDING\_», «\_PROCESSING\_», «\_CANCELED\_» et «\_COMPLETE\_»." enum: - CANCELED - COMPLETE - PENDING - PROCESSING description: >- Represents the result of a batch operation on CRM objects, including the processing status, batch results, timestamps, and a list of any errors encountered during the operation. SimplePublicObjectId: required: - id type: object properties: id: type: string description: >- L'identifiant unique de l'objet, représenté sous forme de chaîne de caractères. example: '430001' description: Contient l'ID d'un objet public SimplePublicObject: 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 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, représenté sous forme de chaîne de caractères. objectWriteTraceId: type: string description: >- Un identifiant de chaîne utilisé pour tracer les opérations d'écriture sur cet objet. properties: type: object additionalProperties: type: string description: >- Une carte des noms de propriétés et de leurs valeurs, où chaque valeur est une chaîne de caractères. propertiesWithHistory: type: object additionalProperties: type: array items: $ref: '#/components/schemas/ValueWithTimestamp' description: >- Une carte des noms de propriétés et de leurs valeurs historiques, où chaque valeur est un tableau d'objets contenant la valeur et l'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: Chaîne de caractères représentant l'URL associée à cet objet. warnings: type: array description: >- Un ensemble d'avertissements liés à cet objet, où chaque avertissement contient une catégorie, un message et un contexte. items: $ref: '#/components/schemas/PublicObjectWarning' description: Un objet public simple. StandardError: required: - category - context - errors - links - message - status type: object properties: category: type: string description: Une chaîne qui catégorise l'erreur. context: type: object additionalProperties: type: array items: type: string description: >- Un objet contenant un contexte additionnel sur la condition d'erreur. Chaque clé correspond à un tableau de chaînes de caractères. errors: type: array description: >- Un tableau d'objets ErrorDetail fournissant des détails supplémentaires sur l'erreur. items: $ref: '#/components/schemas/ErrorDetail' id: type: string description: Une chaîne représentant l'identifiant unique de l'erreur. links: type: object additionalProperties: type: string description: >- Un objet associant des noms de liens à des URI connexes, qui contiennent de la documentation sur l'erreur ou des étapes de remédiation recommandées. message: type: string description: Message lisible par l'être humain décrivant l'erreur. status: type: string description: Une chaîne indiquant le statut de l'erreur. subCategory: type: object properties: {} description: >- Un objet fournissant des détails plus spécifiques sur la catégorie d'erreur. description: >- Représente une réponse aux erreurs standard dans l'API HubSpot, fournissant des informations détaillées sur une erreur survenue lors d'une requête API. 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 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: Chaîne fournissant une étiquette ou une description 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: Une chaîne représentant la valeur de données. description: Modèle de propriété qui inclut un horodatage. PublicObjectWarning: required: - category - context - message type: object properties: category: type: string description: Chaîne représentant 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. 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é 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 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. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' ````