> Portal Navigation: > > - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version. > - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages). > - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`). > - Top-level index of all portals: https://dev.wix.com/docs/llms.txt > - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt # GetJob # Package: operations # Namespace: DataMovementService # Method link: https://dev.wix.com/docs/api-reference/business-solutions/cms/operations/data-movement-jobs/get-job.md ## Permission Scopes: Data Mover Manage Jobs: SCOPE.DC-DATA.MANAGE_MOVEMENT_JOBS ## Introduction Retrieves the specified data movement job. > **Note**: You can only retrieve jobs submitted for the current site. --- ## REST API ### Schema ``` Method: getJob Description: Retrieves the specified data movement job. > **Note**: You can only retrieve jobs submitted for the current site. URL: https://www.wixapis.com/v1/jobs/{jobId} Method: GET # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present. Required parameters: jobId Method parameters: param name: jobId | type: none | required: true Return type: GetJobResponse - name: job | type: DataMovementJob | description: Details of the retrieved job. - ONE-OF: - name: partiallySuccessfulOptions | type: PartiallySuccessfulStatusOptions | description: When the job's `status` is `PARTIALLY_SUCCESSFUL`, the additional details. - name: cause | type: string | description: Reason the job was partially successful. - name: id | type: string | description: Job GUID. - name: startedAt | type: string | description: When the job was submitted. - name: status | type: JobStatus | description: Current job status. - enum: - UNINITIALIZED: Job was submitted but has not yet started. - INITIALIZING: Job is initializing. - IN_PROGRESS: Job is in progress. - COMPLETED: Job has successfully completed. - FAILED: Job has failed. - PARTIALLY_SUCCESSFUL: Job has completed but was partially successful due to a destination limitation. See `PartiallySuccessfulOptions` for additional details. - name: source | type: Source | description: Source to move data from. - ONE-OF: - name: wixDataCollection | type: WixDataSource | description: Wix data collection. You can move items from native Wix collections, [Wix app collections](https://dev.wix.com/docs/develop-websites/articles/databases/wix-data/collections/working-with-wix-app-collections-and-code.md), and [external database collections](https://dev.wix.com/docs/develop-websites/articles/databases/external-databases/overview/integrating-external-databases-with-your-wix-site.md). - name: collectionId | type: string | description: GUID of the data collection. - name: filter | type: object | description: Filter to apply to the items. Only items that pass the filter are moved. Learn more about building a query filter using [API Query Language](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language.md#filters). - name: fields | type: array | description: Item fields to move. If not set, the method moves the full items. - name: localization | type: LocalizationSource | description: Localized CMS content. Available when the site has [Wix Multilingual](https://support.wix.com/en/article/wix-multilingual-an-overview) installed. Learn more about working with [translated CMS content](https://support.wix.com/en/article/wix-multilingual-translating-cms-collection-content). - name: languages | type: array | description: Translated CMS content in the specified languages. Content in these languages is exported to the destination, with the first specified language treated as the main one. Use two-letter language codes in [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes) format. You can also specify a two-letter country code in [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) format. Learn more about [available languages in Wix Multilingual](https://support.wix.com/en/article/wix-multilingual-languages-available). - name: file | type: FileSource | description: Source file. You can import data from files in CSV or JSONL formats. Uploading a file with an invalid format causes the movement job to fail. To upload a file, call Create File Upload Url ([SDK](https://dev.wix.com/docs/sdk/backend-modules/data/movement-jobs/create-file-upload-url.md) | [REST](https://dev.wix.com/docs/rest/business-solutions/cms/data-movement-jobs/create-file-upload-url.md)) and use the `uploadUrl` from the response. For example: `curl --request PUT --upload-file "${path_to_file}" "${uploadUrl}"` - name: format | type: FileFormat | description: File format. If not specified, automatically determined by Wix. - enum: - UNKNOWN: Unknown format. - CSV: CSV format. - JSONL: JSONL format. - name: fileId | type: string | description: File GUID as returned in the `fileId` property of the Create File Upload URL method's response. - name: url | type: string | description: URL where the source file is uploaded. Automatically generated by Wix. - name: destination | type: Destination | description: Destination to move data to. - ONE-OF: - name: wixDataCollection | type: WixDataDestination | description: Wix data collection. You can move items to native Wix collections, [Wix app collections](https://dev.wix.com/docs/develop-websites/articles/databases/wix-data/collections/working-with-wix-app-collections-and-code.md), and [external database collections](https://dev.wix.com/docs/develop-websites/articles/databases/external-databases/overview/integrating-external-databases-with-your-wix-site.md). - name: collectionId | type: string | description: GUID of the destination collection. - name: writePolicy | type: WritePolicy | description: When items already exist in the destination collection, the data writing policy. Default: `OVERWRITE`. - enum: - OVERWRITE: When an item with the same ID exists in the collection, overwrite it. - SKIP_EXISTING: When an item with the same ID exists in the collection, skip it. - TRUNCATE_BEFORE: Clear the destination collection before moving data. When the job completes, the collection contains only the moved data. - name: localization | type: LocalizationDestination | description: Localized CMS content. Available when the site has [Wix Multilingual](https://support.wix.com/en/article/wix-multilingual-an-overview) installed. Learn more about working with [translated CMS content](https://support.wix.com/en/article/wix-multilingual-translating-cms-collection-content). - name: languages | type: array | description: Translated CMS content in the specified languages. Content in these languages is imported from the source, with the first specified language treated as the main one. Use two-letter language codes in [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes) format. You can also specify a two-letter country code in [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) format. Learn more about [available languages in Wix Multilingual](https://support.wix.com/en/article/wix-multilingual-languages-available). - name: file | type: FileDestination | description: Downloadable file with the moved items. - name: format | type: FileFormat | description: File format. - name: fileName | type: string | description: File name. - name: url | type: string | description: File download URL. - name: name | type: string | description: Job name. - name: progress | type: Progress | description: When the job `status` is `IN_PROGRESS`, the progress details. - name: current | type: integer | description: Number of units already processed. - name: total | type: integer | description: Total number of units to move. - name: itemsRejected | type: integer | description: Number of items that failed to move to the destination. - name: itemsSuccessful | type: integer | description: Number of items successfully moved to the destination. - name: finishedAt | type: string | description: Job finish time. A job is considered finished when its `status` updates to `COMPLETED`, `FAILED`, or `PARTIALLY_SUCCESSFUL`. - name: error | type: ApplicationError | description: Error information. - name: code | type: string | description: Error code. - name: description | type: string | description: Description of the error. - name: data | type: object | description: Data related to the error. - name: sourceSiteId | type: string | description: When moving data from a Wix data collection, the source site GUID. By default, the source site is the current site. To move data from [any site in the same Wix Account](https://support.wix.com/en/article/managing-multiple-sites-under-one-account), specify the site GUID, which you can retrieve by calling [Get App Instance](https://dev.wix.com/docs/rest/app-management/app-instance/get-app-instance.md). > **Note**: You can specify the GUID of a source site or destination site, but not both. - name: destinationSiteId | type: string | description: When moving data to a Wix data collection, the destination site GUID. By default, the destination site is the current site. To move data to [any site in the same Wix Account](https://support.wix.com/en/article/managing-multiple-sites-under-one-account), specify the site GUID, which you can retrieve by calling [Get App Instance](https://dev.wix.com/docs/rest/app-management/app-instance/get-app-instance.md). > **Note**: You can specify the GUID of a source site or destination site, but not both. - name: logsRecorded | type: integer | description: Number of recorded logs. - name: scheduleId | type: string | description: Sync Schedule GUID, if the job was triggered by a sync schedule. - name: extendedFields | type: ExtendedFields | description: Extended fields for custom metadata added by applications. - name: namespaces | type: object | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured. You can only access fields for which you have the appropriate permissions. Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields.md). - name: workflowId | type: string | description: Workflow GUID, if the job was created as a child step of a workflow. ``` ### Examples ### GetJob ```curl ~~~cURL curl -X GET 'https://www.wixapis.com/data-mover/v1/jobs/8646fc6e-58f3-4d78-b3ab-6a63a5a46400' \ -H 'Authorization: ' ~~~ ``` --- ## JavaScript SDK ### Schema ``` Method: wixClientAdmin.operations.DataMovementService.getJob(jobId) Description: Retrieves the specified data movement job. > **Note**: You can only retrieve jobs submitted for the current site. # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present. Required parameters: jobId Method parameters: param name: jobId | type: string | description: Job GUID. | required: true Return type: PROMISE - ONE-OF: - name: partiallySuccessfulOptions | type: PartiallySuccessfulStatusOptions | description: When the job's `status` is `PARTIALLY_SUCCESSFUL`, the additional details. - name: cause | type: string | description: Reason the job was partially successful. - name: _id | type: string | description: Job GUID. - name: startedAt | type: Date | description: When the job was submitted. - name: status | type: JobStatus | description: Current job status. - enum: - UNINITIALIZED: Job was submitted but has not yet started. - INITIALIZING: Job is initializing. - IN_PROGRESS: Job is in progress. - COMPLETED: Job has successfully completed. - FAILED: Job has failed. - PARTIALLY_SUCCESSFUL: Job has completed but was partially successful due to a destination limitation. See `PartiallySuccessfulOptions` for additional details. - name: source | type: Source | description: Source to move data from. - ONE-OF: - name: wixDataCollection | type: WixDataSource | description: Wix data collection. You can move items from native Wix collections, [Wix app collections](https://dev.wix.com/docs/develop-websites/articles/databases/wix-data/collections/working-with-wix-app-collections-and-code.md), and [external database collections](https://dev.wix.com/docs/develop-websites/articles/databases/external-databases/overview/integrating-external-databases-with-your-wix-site.md). - name: collectionId | type: string | description: GUID of the data collection. - name: filter | type: object | description: Filter to apply to the items. Only items that pass the filter are moved. Learn more about building a query filter using [API Query Language](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language.md#filters). - name: fields | type: array | description: Item fields to move. If not set, the method moves the full items. - name: localization | type: LocalizationSource | description: Localized CMS content. Available when the site has [Wix Multilingual](https://support.wix.com/en/article/wix-multilingual-an-overview) installed. Learn more about working with [translated CMS content](https://support.wix.com/en/article/wix-multilingual-translating-cms-collection-content). - name: languages | type: array | description: Translated CMS content in the specified languages. Content in these languages is exported to the destination, with the first specified language treated as the main one. Use two-letter language codes in [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes) format. You can also specify a two-letter country code in [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) format. Learn more about [available languages in Wix Multilingual](https://support.wix.com/en/article/wix-multilingual-languages-available). - name: file | type: FileSource | description: Source file. You can import data from files in CSV or JSONL formats. Uploading a file with an invalid format causes the movement job to fail. To upload a file, call Create File Upload Url ([SDK](https://dev.wix.com/docs/sdk/backend-modules/data/movement-jobs/create-file-upload-url.md) | [REST](https://dev.wix.com/docs/rest/business-solutions/cms/data-movement-jobs/create-file-upload-url.md)) and use the `uploadUrl` from the response. For example: `curl --request PUT --upload-file "${path_to_file}" "${uploadUrl}"` - name: format | type: FileFormat | description: File format. If not specified, automatically determined by Wix. - enum: - UNKNOWN: Unknown format. - CSV: CSV format. - JSONL: JSONL format. - name: fileId | type: string | description: File GUID as returned in the `fileId` property of the Create File Upload URL method's response. - name: url | type: string | description: URL where the source file is uploaded. Automatically generated by Wix. - name: destination | type: Destination | description: Destination to move data to. - ONE-OF: - name: wixDataCollection | type: WixDataDestination | description: Wix data collection. You can move items to native Wix collections, [Wix app collections](https://dev.wix.com/docs/develop-websites/articles/databases/wix-data/collections/working-with-wix-app-collections-and-code.md), and [external database collections](https://dev.wix.com/docs/develop-websites/articles/databases/external-databases/overview/integrating-external-databases-with-your-wix-site.md). - name: collectionId | type: string | description: GUID of the destination collection. - name: writePolicy | type: WritePolicy | description: When items already exist in the destination collection, the data writing policy. Default: `OVERWRITE`. - enum: - OVERWRITE: When an item with the same ID exists in the collection, overwrite it. - SKIP_EXISTING: When an item with the same ID exists in the collection, skip it. - TRUNCATE_BEFORE: Clear the destination collection before moving data. When the job completes, the collection contains only the moved data. - name: localization | type: LocalizationDestination | description: Localized CMS content. Available when the site has [Wix Multilingual](https://support.wix.com/en/article/wix-multilingual-an-overview) installed. Learn more about working with [translated CMS content](https://support.wix.com/en/article/wix-multilingual-translating-cms-collection-content). - name: languages | type: array | description: Translated CMS content in the specified languages. Content in these languages is imported from the source, with the first specified language treated as the main one. Use two-letter language codes in [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes) format. You can also specify a two-letter country code in [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) format. Learn more about [available languages in Wix Multilingual](https://support.wix.com/en/article/wix-multilingual-languages-available). - name: file | type: FileDestination | description: Downloadable file with the moved items. - name: format | type: FileFormat | description: File format. - name: fileName | type: string | description: File name. - name: url | type: string | description: File download URL. - name: name | type: string | description: Job name. - name: progress | type: Progress | description: When the job `status` is `IN_PROGRESS`, the progress details. - name: current | type: integer | description: Number of units already processed. - name: total | type: integer | description: Total number of units to move. - name: itemsRejected | type: integer | description: Number of items that failed to move to the destination. - name: itemsSuccessful | type: integer | description: Number of items successfully moved to the destination. - name: finishedAt | type: Date | description: Job finish time. A job is considered finished when its `status` updates to `COMPLETED`, `FAILED`, or `PARTIALLY_SUCCESSFUL`. - name: error | type: ApplicationError | description: Error information. - name: code | type: string | description: Error code. - name: description | type: string | description: Description of the error. - name: data | type: object | description: Data related to the error. - name: sourceSiteId | type: string | description: When moving data from a Wix data collection, the source site GUID. By default, the source site is the current site. To move data from [any site in the same Wix Account](https://support.wix.com/en/article/managing-multiple-sites-under-one-account), specify the site GUID, which you can retrieve by calling [Get App Instance](https://dev.wix.com/docs/rest/app-management/app-instance/get-app-instance.md). > **Note**: You can specify the GUID of a source site or destination site, but not both. - name: destinationSiteId | type: string | description: When moving data to a Wix data collection, the destination site GUID. By default, the destination site is the current site. To move data to [any site in the same Wix Account](https://support.wix.com/en/article/managing-multiple-sites-under-one-account), specify the site GUID, which you can retrieve by calling [Get App Instance](https://dev.wix.com/docs/rest/app-management/app-instance/get-app-instance.md). > **Note**: You can specify the GUID of a source site or destination site, but not both. - name: logsRecorded | type: integer | description: Number of recorded logs. - name: scheduleId | type: string | description: Sync Schedule GUID, if the job was triggered by a sync schedule. - name: extendedFields | type: ExtendedFields | description: Extended fields for custom metadata added by applications. - name: namespaces | type: object | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured. You can only access fields for which you have the appropriate permissions. Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields.md). - name: workflowId | type: string | description: Workflow GUID, if the job was created as a child step of a workflow. ``` ### Examples ### getJob ```javascript import { movementJobs } from '@wix/data'; async function getJob(jobId) { const response = await movementJobs.getJob(jobId); }; ``` ### getJob (with elevated permissions) ```javascript import { movementJobs } from '@wix/data'; import { auth } from '@wix/essentials'; async function myGetJobMethod(jobId) { const elevatedGetJob = auth.elevate(movementJobs.getJob); const response = await elevatedGetJob(jobId); } ``` ### getJob (self-hosted) Self-hosted SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md). ```javascript import { createClient } from '@wix/sdk'; import { movementJobs } from '@wix/data'; // Import the auth strategy for the relevant access type // Import the relevant host module if needed const myWixClient = createClient ({ modules: { movementJobs }, // Include the auth strategy and host as relevant }); async function getJob(jobId) { const response = await myWixClient.movementJobs.getJob(jobId); }; ``` ---