> ## 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. # Get active imports > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/legacy/v3/crm-imports-v3.json GET /crm/v3/imports openapi: 3.0.1 info: title: CRM Imports description: Basepom for all HubSpot Projects version: v3 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE x-hubspot-related-documentation: - name: Import CRM Guide url: https://developers.hubspot.com/docs/guides/api/crm/imports servers: - url: https://api.hubapi.com security: [] tags: - name: Advanced - name: Basic paths: /crm/v3/imports: get: tags: - Basic operationId: get-/crm/v3/imports_/crm/v3/imports parameters: - name: after in: query required: false style: form explode: true schema: type: string - name: limit in: query required: false style: form explode: true schema: type: integer format: int32 responses: '200': description: successful operation content: application/json: schema: $ref: >- #/components/schemas/CollectionResponsePublicImportResponseForwardPaging default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - crm.import components: schemas: CollectionResponsePublicImportResponseForwardPaging: required: - results type: object properties: paging: $ref: '#/components/schemas/ForwardPaging' results: type: array items: $ref: '#/components/schemas/PublicImportResponse' 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." PublicImportResponse: required: - createdAt - id - mappedObjectTypeIds - metadata - optOutImport - state - updatedAt type: object properties: 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'identifiant unique pour cet import. importName: type: string description: Le nom fourni par l'utilisateur pour cet import. importRequestJson: type: object properties: {} description: >- La configuration complète de la demande d'import sous forme d'objet JSON. importSource: type: string description: Indique où/comment l'import a été lancé. enum: - API - CRM_UI - IMPORT - MOBILE_ANDROID - MOBILE_IOS - SALESFORCE importTemplate: $ref: '#/components/schemas/ImportTemplate' mappedObjectTypeIds: type: array items: type: string metadata: $ref: '#/components/schemas/PublicImportMetadata' optOutImport: type: boolean description: >- Si l'importation est une liste de personnes qui ne doivent plus recevoir des e-mails ou non. state: type: string description: Le statut de l'importation. enum: - CANCELED - DEFERRED - DONE - FAILED - PROCESSING - REVERTED - STARTED updatedAt: type: string description: "L'horodatage de la dernière mise à jour de la fiche d'informations de l'import, au format ISO\_8601 instantané." format: date-time 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 ImportTemplate: required: - templateId - templateType type: object properties: templateId: type: integer description: >- L'identifiant unique du modèle enregistré spécifique ou de l'import précédent référencé. format: int64 templateType: type: string description: >- La classification du type de modèle représenté, ainsi que son origine ou son objectif. enum: - admin_defined - previous_import - user_file PublicImportMetadata: required: - counters - fileIds - objectLists type: object properties: counters: type: object additionalProperties: type: integer format: int32 description: >- Résultats résumés de chaque ligne qu'un développeur a tenté d'importer dans HubSpot. fileIds: type: array description: >- Les ID des fichiers téléchargés dans l'API du gestionnaire de fichiers. items: type: string objectLists: type: array description: Les listes contenant les objets importés. items: $ref: '#/components/schemas/PublicObjectListRecord' 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. PublicObjectListRecord: required: - listId - objectType type: object properties: listId: type: string description: L'ID de la liste contenant les objets importés. objectType: type: string description: Le type d'objet contenu dans la liste. 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.import: '' ````