> 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

# ListMovementLogs

# Package: operations

# Namespace: DataMovementService

# Method link: https://dev.wix.com/docs/api-reference/business-solutions/cms/operations/data-movement-jobs/list-movement-logs.md

## Permission Scopes:
Data Mover Manage Jobs: SCOPE.DC-DATA.MANAGE_MOVEMENT_JOBS

## Introduction

Lists logs for the specified job.

Logs are generated by the destination for each item that failed to move. Some destinations also generate logs for items that moved successfully.

---

## REST API

### Schema

```
 Method: listMovementLogs
 Description: Lists logs for the specified job.  Logs are generated by the destination for each item that failed to move. Some destinations also generate logs for items that moved successfully.
 URL: https://www.wixapis.com/v1/jobs/{jobId}/logs
 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
   param name: paging | type: CursorPaging   
        - name: limit | type: integer | description: Maximum number of items to return in the results. 
        - name: cursor | type: string | description: Pointer to the next or previous page in the list of results.  Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response. Not relevant for the first request. 
 Return type: ListMovementLogsResponse
  - name: logs | type: array<MovementLog> | description: Job logs. 
     - name: sourceItemId | type: string | description: GUID of the item in the source, such as a Wix Data Item or a row number in a CSV file. 
     - name: failure | type: ApplicationError | description: Details about the failure if moving the item fails. 
        - 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: details | type: object | description: Additional details provided when moving the item succeeds with details.  > **Note**: Each destination type determines the structure of its `details` object. 
  - name: pagingMetadata | type: CursorPagingMetadata | description: Paging metadata. 
     - name: count | type: integer | description: Number of items returned in current page. 
     - name: cursors | type: Cursors | description: Cursor strings that point to the next page, previous page, or both. 
        - name: next | type: string | description: Cursor string pointing to the next page in the list of results. 
        - name: prev | type: string | description: Cursor pointing to the previous page in the list of results. 
     - name: hasNext | type: boolean | description: Whether there are more pages to retrieve following the current page.  + `true`: Another page of results can be retrieved. + `false`: This is the last page. 


```

### Examples

### List logs for the specified job
```curl
curl -X GET 'https://www.wixapis.com/data-mover/v1/jobs/8646fc6e-58f3-4d78-b3ab-6a63a5a46400/logs' \
    -H 'Authorization: <AUTH>'
```

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.operations.DataMovementService.listMovementLogs(jobId, options)
 Description: Lists logs for the specified job.  Logs are generated by the destination for each item that failed to move. Some destinations also generate logs for items that moved successfully.
 # 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: GUID of the job for which to list logs. | required: true
   param name: options | type: ListMovementLogsOptions  none 
        - name: paging | type: CursorPaging | description: Paging metadata. 
           - name: limit | type: integer | description: Maximum number of items to return in the results. 
           - name: cursor | type: string | description: Pointer to the next or previous page in the list of results.  Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response. Not relevant for the first request. 
 Return type: PROMISE<ListMovementLogsResponse>
  - name: logs | type: array<MovementLog> | description: Job logs. 
     - name: sourceItemId | type: string | description: GUID of the item in the source, such as a Wix Data Item or a row number in a CSV file. 
     - name: failure | type: ApplicationError | description: Details about the failure if moving the item fails. 
        - 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: details | type: object | description: Additional details provided when moving the item succeeds with details.  > **Note**: Each destination type determines the structure of its `details` object. 
  - name: pagingMetadata | type: CursorPagingMetadata | description: Paging metadata. 
     - name: count | type: integer | description: Number of items returned in current page. 
     - name: cursors | type: Cursors | description: Cursor strings that point to the next page, previous page, or both. 
        - name: next | type: string | description: Cursor string pointing to the next page in the list of results. 
        - name: prev | type: string | description: Cursor pointing to the previous page in the list of results. 
     - name: hasNext | type: boolean | description: Whether there are more pages to retrieve following the current page.  + `true`: Another page of results can be retrieved. + `false`: This is the last page. 


```

### Examples

### listMovementLogs
```javascript
import { movementJobs } from '@wix/data';

async function listMovementLogs(jobId,options) {
  const response = await movementJobs.listMovementLogs(jobId,options);
};
```

### listMovementLogs (with elevated permissions)
```javascript
import { movementJobs } from '@wix/data';
import { auth } from '@wix/essentials';

async function myListMovementLogsMethod(jobId,options) {
  const elevatedListMovementLogs = auth.elevate(movementJobs.listMovementLogs);
  const response = await elevatedListMovementLogs(jobId,options);
}
```

### listMovementLogs (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 listMovementLogs(jobId,options) {
  const response = await myWixClient.movementJobs.listMovementLogs(jobId,options);
};
```

---