> ## 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. # Batch read properties > Récupérer un lot de propriétés pour un type d'objet spécifié au sein d'une application donnée. Ce point de terminaison est utile pour récupérer efficacement plusieurs propriétés en une seule requête, en particulier lors du traitement de grands jeux de données ou lorsque des propriétés spécifiques sont nécessaires pour le traitement. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-09/cms-media-bridge-v2026-09.json POST /media-bridge/2026-09/{appId}/properties/{objectType}/batch/read openapi: 3.0.1 info: title: CMS Media Bridge 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 paths: /media-bridge/2026-09/{appId}/properties/{objectType}/batch/read: post: tags: - Batch summary: Lire par lots les propriétés description: >- Récupérer un lot de propriétés pour un type d'objet spécifié au sein d'une application donnée. Ce point de terminaison est utile pour récupérer efficacement plusieurs propriétés en une seule requête, en particulier lors du traitement de grands jeux de données ou lorsque des propriétés spécifiques sont nécessaires pour le traitement. operationId: post-/media-bridge/2026-09/{appId}/properties/{objectType}/batch/read parameters: - name: appId in: path description: >- L'identifiant unique de l'application à partir de laquelle les propriétés sont récupérées, ce qui garantit que la requête est dirigée vers le contexte d'application approprié. required: true style: simple explode: false schema: type: integer format: int32 - name: objectType in: path description: >- Le type d'objet pour lequel les propriétés sont récupérées. Cela identifie la catégorie ou l'entité spécifique au sein de l'application. required: true style: simple explode: false schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/BatchReadInputPropertyName' required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/BatchResponseProperty' '207': description: multiple statuses content: application/json: schema: $ref: '#/components/schemas/BatchResponsePropertyWithErrors' default: $ref: '#/components/responses/Error' description: '' security: - developer_hapikey: [] components: schemas: BatchReadInputPropertyName: required: - archived - dataSensitivity - inputs type: object properties: archived: type: boolean description: "Un booléen indiquant s'il faut inclure les propriétés archivées dans la lecture par lots. La valeur par défaut est «\_false\_» si elle n'est pas spécifiée." dataSensitivity: type: string description: >- Une chaîne représentant le niveau de sensibilité des données consultées. Cette propriété aide à déterminer les mesures de sécurité nécessaires pour le traitement des données. enum: - highly_sensitive - non_sensitive - sensitive inputs: type: array description: >- Un tableau de chaînes, chacune représentant un nom de propriété à inclure dans l'opération de lecture par lot. items: $ref: '#/components/schemas/PropertyName' BatchResponseProperty: 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 collection de liens liés à l'opération de lot, généralement utilisés pour la navigation ou des actions supplémentaires. 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 contenant les résultats de l'opération de lot, précisant l'issue pour chaque propriété concernée. items: $ref: '#/components/schemas/Property' startedAt: type: string description: >- La date et l'heure auxquelles l'opération par lot a commencé, au format ISO 8601. format: date-time status: type: string description: >- Le statut actuel de l'opération par lot, indiquant le succès ou l'échec. enum: - CANCELED - COMPLETE - PENDING - PROCESSING BatchResponsePropertyWithErrors: 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: >- Tableau contenant les détails des erreurs pour les propriétés qui ont échoué lors de l'opération par lot. items: $ref: '#/components/schemas/StandardError' links: type: object additionalProperties: type: string description: >- Une collection de liens liés à l'opération par lot, généralement utilisés pour la navigation ou des actions supplémentaires. 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 contenant les résultats de l'opération par lot, détaillant le résultat de l'opération de chaque propriété. items: $ref: '#/components/schemas/Property' 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 global de l'opération par lot, indiquant le succès ou l'échec. enum: - CANCELED - COMPLETE - PENDING - PROCESSING PropertyName: required: - name type: object properties: name: type: string description: Une chaîne représentant le nom de la propriété. Property: required: - allowedObjectTypes - calculated - canArchive - canRestore - createdAt - createdUserId - currencyPropertyName - dataSensitivity - dateDisplayHint - deleted - description - displayMode - displayOrder - enforceMultivalueUniqueness - externalOptions - externalOptionsReferenceType - favorited - favoritedOrder - fieldType - formField - fromUserId - groupName - hasUniqueValue - hidden - hubspotDefined - isCustomizedDefault - isMultiValued - isPartial - label - mutableDefinitionNotDeletable - name - numberDisplayHint - optionSortStrategy - options - optionsAreMutable - owningAppId - portalId - readOnlyDefinition - readOnlyValue - referencedObjectType - searchTextAnalysisMode - searchableInGlobalSearch - sensitiveDataCategories - showCurrencySymbol - textDisplayHint - type - updatedAt type: object properties: allowedObjectTypes: type: array description: >- Un tableau de chaînes de caractères représentant les types d'objets autorisés pour cette propriété. items: $ref: '#/components/schemas/ObjectTypeIdProto' calculated: type: boolean description: Un booléen indiquant si la propriété est calculée. canArchive: type: boolean description: Un booléen indiquant si la propriété peut être archivée. canRestore: type: boolean description: Un booléen indiquant si la propriété peut être restaurée. createdAt: type: integer description: >- Une chaîne représentant la date et l'heure de création de la propriété, au format ISO 8601. format: int64 createdUserId: type: integer description: Chaîne représentant l'ID de l'utilisateur qui a créé la propriété. format: int64 currencyPropertyName: type: string description: >- Une chaîne représentant le nom de la propriété de devise associée à cette propriété. dataSensitivity: type: string description: Une chaîne indiquant le niveau de sensibilité des données. enum: - high - none - standard dateDisplayHint: type: string description: Une chaîne fournissant une indication pour l'affichage des dates. enum: - absolute - absolute_with_relative - time_since - time_until deleted: type: boolean description: Un booléen indiquant si la propriété a été supprimée. description: type: string description: Une chaîne fournissant une description de la propriété. displayMode: type: string description: Une chaîne indiquant le mode d'affichage de la propriété. enum: - all_unique_versions - current_value displayOrder: type: integer description: Un entier spécifiant l'ordre dans lequel la propriété est affichée. format: int32 enforceMultivalueUniqueness: type: boolean description: >- Un booléen indiquant si l'unicité est appliquée pour les propriétés à valeurs multiples. externalOptions: type: boolean description: >- Une propriété booléenne indiquant si la propriété a des options externes. externalOptionsReferenceType: type: string description: Chaîne indiquant le type de référence pour les options externes. favorited: type: boolean description: Un booléen indiquant si la propriété est marquée comme favorite. favoritedOrder: type: integer description: Un entier spécifiant l'ordre de la propriété parmi les favoris. format: int32 fieldType: type: string description: "Une chaîne indiquant le type de champ de la propriété, tel que «\_booleancheckbox\_», «\_calculation_equation\_», «\_checkbox\_», «\_date\_», «\_file\_», «\_html\_», «\_number\_», «\_phonenumber\_», «\_radio\_», «\_select\_», «\_text\_» ou «\_textarea\_»." formField: type: boolean description: >- Un booléen indiquant si la propriété est utilisée comme champ de formulaire. fromUserId: type: integer description: >- Une chaîne représentant l'ID utilisateur à l'origine de la propriété. format: int64 groupName: type: string description: >- Une chaîne représentant le nom du groupe auquel appartient la propriété. hasUniqueValue: type: boolean description: Un booléen indiquant si la propriété a une valeur unique. hidden: type: boolean description: Un booléen indiquant si la propriété est masquée. example: false hubspotDefined: type: boolean description: Un booléen indiquant si la propriété est définie par HubSpot. isCustomizedDefault: type: boolean description: >- Un booléen indiquant si la propriété est une valeur par défaut personnalisée. isMultiValued: type: boolean description: Un booléen indiquant si la propriété peut avoir plusieurs valeurs. isPartial: type: boolean description: Un booléen indiquant si la propriété est partielle. label: type: string description: >- Une chaîne représentant le libellé de la propriété, utilisée à des fins d'affichage. mutableDefinitionNotDeletable: type: boolean description: >- Un booléen indiquant si la définition de la propriété est modifiable mais non supprimable. name: type: string description: Une chaîne représentant le nom de la propriété. numberDisplayHint: type: string description: "Une chaîne fournissant une indication pour l'affichage des nombres, avec des options telles que «\_non formaté\_», «\_formaté\_», «\_devise\_», «\_pourcentage\_», «\_durée\_» ou «\_probabilité\_»." enum: - currency - duration - formatted - percentage - probability - unformatted optionSortStrategy: type: string description: Une chaîne indiquant la stratégie utilisée pour trier les options. enum: - ALPHABETICAL - DISPLAY_ORDER options: type: array description: >- Un éventail d'options disponibles pour la propriété, applicable si le type de propriété prend en charge les options. items: $ref: '#/components/schemas/Option' optionsAreMutable: type: boolean description: Un booléen indiquant si les options de la propriété sont mutables. owningAppId: type: integer description: >- Un entier représentant l'ID de l'application propriétaire de la propriété. format: int64 portalId: type: integer description: Un entier représentant l'identifiant unique du portail. format: int64 readOnlyDefinition: type: boolean description: Un booléen indiquant si la propriété est en lecture seule. readOnlyValue: type: boolean description: >- Un booléen indiquant si la valeur de la propriété est en lecture seule. referencedObjectType: type: string description: Une chaîne indiquant le type d'objet référencé par la propriété. enum: - ABANDONED_CART - ACCEPTANCE_TEST - AD - AD_ACCOUNT - AD_CAMPAIGN - AD_GROUP - AI_FORECAST - ALL_PAGES - APPROVAL - APPROVAL_STEP - ATTRIBUTION - AUDIENCE - AUTOMATION_JOURNEY - AUTOMATION_PLATFORM_FLOW - AUTOMATION_PLATFORM_FLOW_ACTION - BET_ALERT - BET_DELIVERABLE_SERVICE - BLOG_LISTING_PAGE - BLOG_POST - CALL - CAMPAIGN - CAMPAIGN_BUDGET_ITEM - CAMPAIGN_SPEND_ITEM - CAMPAIGN_STEP - CAMPAIGN_TEMPLATE - CAMPAIGN_TEMPLATE_STEP - CART - CASE_STUDY - CHATFLOW - CLIP - CMS_URL - COMBO_EVENT_CONFIGURATION - COMMERCE_PAYMENT - COMMUNICATION - COMPANY - CONTACT - CONTACT_CREATE_ATTRIBUTION - CONTENT - CONTENT_AUDIT - CONTENT_AUDIT_PAGE - CONVERSATION - CONVERSATION_INBOX - CONVERSATION_SESSION - CRM_OBJECTS_DUMMY_TYPE - CRM_PIPELINES_DUMMY_TYPE - CTA - CTA_VARIANT - DATA_PRIVACY_CONSENT - DATA_SYNC_STATE - DEAL - DEAL_CREATE_ATTRIBUTION - DEAL_REGISTRATION - DEAL_SPLIT - DISCOUNT - DISCOUNT_CODE - DISCOUNT_TEMPLATE - EMAIL - ENGAGEMENT - EXPORT - EXTERNAL_WEB_URL - FEE - FEEDBACK_SUBMISSION - FEEDBACK_SURVEY - FILE_MANAGER_FILE - FILE_MANAGER_FOLDER - FOLDER - FORECAST - FORM - FORM_SUBMISSION_INBOUNDDB - GOAL_TARGET - GOAL_TARGET_GROUP - GOAL_TEMPLATE - GSC_PROPERTY - HUB - IMPORT - INVOICE - KEYWORD - KNOWLEDGE_ARTICLE - LANDING_PAGE - LEAD - LINE_ITEM - MARKETING_CALENDAR - MARKETING_CAMPAIGN_UTM - MARKETING_EMAIL - MARKETING_EVENT - MARKETING_EVENT_ATTENDANCE - MARKETING_SMS - MEDIA_BRIDGE - MEETING_EVENT - MIC - NOTE - OBJECT_LIST - ORDER - OWNER - PARTNER_ACCOUNT - PARTNER_CLIENT - PARTNER_CLIENT_REVENUE - PARTNER_SERVICE - PAYMENT_LINK - PAYMENT_SCHEDULE - PAYMENT_SCHEDULE_INSTALLMENT - PERMISSIONS_TESTING - PLAYBOOK - PLAYBOOK_QUESTION - PLAYBOOK_SUBMISSION - PLAYBOOK_SUBMISSION_ANSWER - PLAYLIST - PLAYLIST_FOLDER - PODCAST_EPISODE - PORTAL - PORTAL_OBJECT_SYNC_MESSAGE - POSTAL_MAIL - PRIVACY_SCANNER_COOKIE - PRODUCT - PRODUCT_OR_FOLDER - PROPERTY_INFO - PROSPECTING_AGENT_CONTACT_ASSIGNMENT - PUBLISHING_TASK - QUARANTINED_SUBMISSION - QUOTA - QUOTE - QUOTE_FIELD - QUOTE_MODULE - QUOTE_MODULE_FIELD - QUOTE_TEMPLATE - RESTORABLE_CRM_OBJECT - ROSTER - ROSTER_MEMBER - SALES_DOCUMENT - SALES_TASK - SALES_WORKLOAD - SALESFORCE_SYNC_ERROR - SCHEDULING_PAGE - SCHEMAS_BACKEND_TEST - SCORE_CONFIGURATION - SEQUENCE - SEQUENCE_ENROLLMENT - SEQUENCE_STEP - SEQUENCE_STEP_ENROLLMENT - SERVICE - SITE_PAGE - SNIPPET - SOCIAL_BROADCAST - SOCIAL_CHANNEL - SOCIAL_POST - SOCIAL_PROFILE - SOX_PROTECTED_DUMMY_TYPE - SOX_PROTECTED_TEST_TYPE - SUBMISSION_TAG - SUBSCRIPTION - TASK - TASK_TEMPLATE - TAX - TEMPLATE - TICKET - UNKNOWN - UNSUBSCRIBE - USER - VIEW - VIEW_BLOCK - WEB_INTERACTIVE searchTextAnalysisMode: type: string description: >- Une chaîne indiquant le mode d'analyse de texte à des fins de recherche. enum: - NONE - NOT_ANALYZED_TEXT searchableInGlobalSearch: type: boolean description: >- Un booléen indiquant si la propriété peut faire l'objet d'une recherche globale. sensitiveDataCategories: type: array description: >- Un tableau de chaînes de caractères représentant les catégories de données sensibles associées à cette propriété. items: type: string showCurrencySymbol: type: boolean description: >- Un booléen indiquant si le symbole monétaire doit être affiché pour la propriété. textDisplayHint: type: string description: "Une chaîne fournissant une indication pour l'affichage du texte, avec des options telles que «\_unformatted_single_line\_», «\_multi_line\_», «\_email\_», «\_phone_number\_», «\_domain_name\_», «\_ip_address\_», «\_physical_address\_» ou «\_postal_code\_»." enum: - domain_name - email - ip_address - multi_line - phone_number - physical_address - postal_code - unformatted_single_line type: type: string description: "Une chaîne de caractères indiquant le type de la propriété, tel que «\_bool\_», «\_date\_», «\_datetime\_», «\_enumeration\_», «\_number\_», «\_phone_number\_» ou «\_string\_»." enum: - bool - currency_number - date - datetime - enumeration - json - number - object_coordinates - phone_number - string - time_range updatedAt: type: integer description: >- Une chaîne représentant la date et l'heure de la dernière mise à jour de la propriété, au format ISO 8601. format: int64 description: A HubSpot property StandardError: required: - category - context - errors - links - message - status type: object properties: category: type: string description: >- Une classification générale de l'erreur, indiquant le type de problème rencontré. context: type: object additionalProperties: type: array items: type: string description: >- Une carte de contexte ou de métadonnées supplémentaires liées à l'erreur, pouvant inclure des paramètres ou des valeurs spécifiques impliqués dans l'erreur. errors: type: array description: >- Un ensemble de messages ou de codes d'erreur détaillés qui fournissent des informations plus granulaires sur l'erreur. items: $ref: '#/components/schemas/ErrorDetail' id: type: string description: Un identifiant unique pour l'instance d'erreur. links: type: object additionalProperties: type: string description: >- Une collection d'URL ou de références à des ressources ou à une documentation connexe pouvant aider à comprendre ou à résoudre l'erreur. message: type: string description: Un message lisible par l'utilisateur décrivant l'erreur. status: type: string description: Le code d'état HTTP associé à l'erreur. subCategory: type: object properties: {} description: >- Une classification plus spécifique de l'erreur, fournissant un contexte additionnel sur le problème. description: Ye olde error 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 ObjectTypeIdProto: required: - innerId - metaTypeId type: object properties: innerId: type: integer description: >- Une propriété représentant probablement un identifiant interne pour le type d'objet. Le type de données n'est pas spécifié dans la spécification fournie. format: int32 metaTypeId: type: integer description: >- Une propriété qui fait probablement référence à un identifiant de méta-type associé au type d'objet. Le type de données n'est pas spécifié dans la spécification fournie. format: int32 Option: required: - description - displayOrder - doubleData - hidden - label - readOnly - value type: object properties: description: type: string description: >- Une chaîne de caractères fournissant des informations supplémentaires sur l'option. displayOrder: type: integer description: >- Un entier indiquant l'ordre dans lequel l'option doit être affichée par rapport aux autres options. format: int32 doubleData: type: number description: >- Nombre pouvant fournir des données supplémentaires associées à l'option. hidden: type: boolean description: Un booléen indiquant si l'option est masquée de l'affichage. label: type: string description: Chaîne représentant le nom d'affichage de l'option. readOnly: type: boolean description: >- Un booléen spécifiant si l'option est en lecture seule et ne peut pas être modifiée. value: type: string description: Une chaîne représentant la valeur unique associée à l'option. description: A HubSpot property option 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' securitySchemes: developer_hapikey: type: apiKey name: hapikey in: query ````