> ## 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 mappings > Récupérez une liste de mappages d'URL depuis le compte HubSpot. Ce point de terminaison donne accès aux configurations de mappage d'URL, qui peuvent être utilisées pour gérer et rediriger les URL au sein du CMS HubSpot. Il est utile pour comprendre comment les URL sont structurées et redirigées dans votre configuration de gestion de contenu. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-09/cms-url-mappings-v2026-09.json GET /url-mappings/2026-09/url-mappings openapi: 3.0.1 info: title: Mappages d'URL 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 paths: /url-mappings/2026-09/url-mappings: get: tags: - Basic summary: Lister les mappages d'URL description: >- Récupérez une liste de mappages d'URL depuis le compte HubSpot. Ce point de terminaison donne accès aux configurations de mappage d'URL, qui peuvent être utilisées pour gérer et rediriger les URL au sein du CMS HubSpot. Il est utile pour comprendre comment les URL sont structurées et redirigées dans votre configuration de gestion de contenu. operationId: get-/url-mappings/2026-09/url-mappings_/url-mappings/v3/url-mappings parameters: [] responses: '200': description: successful operation content: '*/*': schema: type: array items: $ref: '#/components/schemas/UrlMapping' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - content components: schemas: UrlMapping: required: - cdnPurgeEmbargoTime - contentGroupId - cosObjectType - created - createdById - deletedAt - destination - id - internallyCreated - isActive - isMatchFullUrl - isMatchQueryString - isOnlyAfterNotFound - isPattern - isProtocolAgnostic - isRegex - isTrailingSlashOptional - label - lastUsedAt - name - note - portalId - precedence - redirectStyle - routePrefix - updated - updatedById type: object properties: cdnPurgeEmbargoTime: type: integer description: "Un horodatage\_Unix en millisecondes indiquant l'heure d'embargo pour la purge du réseau de diffusion de contenu liée au mappage d'URL." format: int64 contentGroupId: type: integer description: "Un entier 64\_bits représentant le groupe de contenu associé au mappage d'URL." format: int64 cosObjectType: type: string description: "Une chaîne représentant le type d'objet de contenu associé au mappage d'URL. Les valeurs valides incluent divers types de contenu tels que «\_CONTENT\_», «\_LAYOUT\_», «\_FILE\_», etc." enum: - ACCESS_GROUP_MEMBERSHIP - APP_PAGE - BLOCK - BLOG - BLOG_AUTHOR - BRAND_BUSINESS_UNIT - BRAND_SETTINGS - CONTACT_MEMBERSHIP - CONTENT - CONTENT_EMBED - CONTENT_FOLDER - CONTENT_GROUP - CRM_OBJECT - CRM_OBJECT_TYPE - CUSTOM_WIDGET - CUSTOMER_PORTAL - DATA_QUERY - DESIGN_FOLDER - DOMAIN - DOMAIN_SETTINGS - EMAIL_ADDRESS - EXTENSION_RESOURCE - FILE - FOLDER - FOLLOW_ME - FORM - GLOBAL_CONTENT - GLOBAL_STYLES_THEME - HUBDB_TABLE - HUBDB_TABLE_ROW - IMAGE - JS_PROJECT_COMPONENT - KNOWLEDGE_BASE - KNOWLEDGE_CATEGORY - KNOWLEDGE_CATEGORY_TRANSLATION - KNOWLEDGE_HOMEPAGE_CATEGORY - LAYOUT - LAYOUT_SECTION - LIST_MEMBERSHIP - MARKETPLACE_LISTING - PASSWORD_PROTECTED - PAYMENT - PERSONALIZATION_TOKEN - PLACEMENT - PROJECT - QUOTE_TEMPLATE - RAW_ASSET - REDIRECT_URL - SECTION - SERVERLESS_FUNCTION - SITE_MAP - SITE_MENU - SITE_SETTINGS - SUBSCRIPTIONS_SETTINGS - TAG - THEME - THEME_SETTINGS - UNRESTRICTED_ACCESS - URL_MAPPING - VIDEO_PLAYER - WIDGET - WORKFLOW created: type: integer description: >- Un horodatage Unix en millisecondes indiquant la date de création du mappage d'URL. format: int64 createdById: type: integer description: >- L'identifiant de l'utilisateur ou de l'utilisatrice qui a créé le mappage d'URL. format: int32 deletedAt: type: integer description: "Un horodatage\_Unix en millisecondes indiquant la date de suppression du mappage d'URL." format: int64 destination: type: string description: L'URL de destination vers laquelle le routePrefix est redirigé. id: type: integer description: "L'identifiant unique du mappage d'URL, représenté sous la forme d'un entier de 64\_bits." format: int64 internallyCreated: type: boolean description: >- Un booléen indiquant si le mappage d'URL a été créé en interne par le système. isActive: type: boolean description: Un booléen indiquant si le mappage d'URL est actuellement actif. isMatchFullUrl: type: boolean description: >- Un booléen indiquant si l'URL complète doit être mise en correspondance. isMatchQueryString: type: boolean description: >- Une valeur booléenne indiquant si la chaîne de requête doit être mise en correspondance. isOnlyAfterNotFound: type: boolean description: >- Un booléen indiquant si le mappage doit être appliqué uniquement après une réponse 404 introuvable. isPattern: type: boolean description: Un booléen indiquant si le routePrefix est un modèle. isProtocolAgnostic: type: boolean description: >- Un booléen indiquant si le mappage doit ignorer le protocole URL (http/https). isRegex: type: boolean description: >- Un booléen indiquant si le routePrefix doit être traité comme une expression régulière. isTrailingSlashOptional: type: boolean description: >- Un booléen indiquant si la barre oblique finale dans l'URL est facultative. label: type: string description: Un libellé pour le mappage d'URL. lastUsedAt: type: integer description: >- Un horodatage Unix en millisecondes indiquant la dernière fois que le mappage d'URL a été utilisé. format: int64 name: type: string description: Le nom du mappage d'URL. note: type: string description: Une chaîne contenant des notes sur le mappage d'URL. portalId: type: integer description: L'identifiant du Portail HubSpot associé à ce mappage d'URL. format: int32 precedence: type: integer description: >- Un entier représentant la précédence du mappage d'URL, utilisé pour déterminer l'ordre d'évaluation. format: int32 redirectStyle: type: integer description: Un entier représentant le style de redirection utilisé. format: int32 routePrefix: type: string description: Le préfixe du chemin d'URL qui est mappé. updated: type: integer description: >- Un horodatage Unix en millisecondes indiquant la dernière mise à jour du mappage d'URL. format: int64 updatedById: type: integer description: >- L'identifiant de l'utilisateur ayant mis à jour le mappage d'URL en dernier. format: int32 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 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. 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: content: '' ````