---
title: "POST /metadata-transfer-jobs-list"
method: POST
path: "/metadata-transfer-jobs-list"
---

# POST /metadata-transfer-jobs-list

`POST /metadata-transfer-jobs-list`

Lists the metadata transfer jobs.

## Request body

- object
  - `sourceType` 's3' | 'iotsitewise' | 'iottwinmaker', required — The metadata transfer job's source type.
  - `destinationType` 's3' | 'iotsitewise' | 'iottwinmaker', required — The metadata transfer job's destination type.
  - `filters` ListMetadataTransferJobsFilter[] — An object that filters metadata transfer jobs.
    - `workspaceId` string — The workspace Id.
    - `state` 'VALIDATING' | 'PENDING' | 'RUNNING' | 'CANCELLING' | 'ERROR' | 'COMPLETED' | 'CANCELLED' — The filter state.
  - `nextToken` string — The string that specifies the next page of results.
  - `maxResults` integer — The maximum number of results to return at one time.

## Response `200`

Success

- ListMetadataTransferJobsResponse
  - `metadataTransferJobSummaries` MetadataTransferJobSummary[], required — The metadata transfer job summaries.
    - `metadataTransferJobId` string, required — The metadata transfer job summary Id.
    - `arn` string, required — The metadata transfer job summary ARN.
    - `creationDateTime` string, date-time, required — The metadata transfer job summary creation DateTime object.
    - `updateDateTime` string, date-time, required — The metadata transfer job summary update DateTime object
    - `status` object, required — The metadata transfer job summary status.
      - `state` 'VALIDATING' | 'PENDING' | 'RUNNING' | 'CANCELLING' | 'ERROR' | 'COMPLETED' | 'CANCELLED' — The metadata transfer job state.
      - `error` object — The metadata transfer job error.
        - `code` 'VALIDATION_ERROR' | 'INTERNAL_FAILURE' | 'SYNC_INITIALIZING_ERROR' | 'SYNC_CREATING_ERROR' | 'SYNC_PROCESSING_ERROR' | 'SYNC_DELETING_ERROR' | 'PROCESSING_ERROR' | 'COMPOSITE_COMPONENT_FAILURE' — The error code.
        - `message` string — The error message.
      - `queuedPosition` integer — The queued position.
    - `progress` object — The metadata transfer job summary progess.
      - `totalCount` integer — The total count. [of what]
      - `succeededCount` integer — The succeeded count.
      - `skippedCount` integer — The skipped count.
      - `failedCount` integer — The failed count.
  - `nextToken` string — The string that specifies the next page of results.

## Other responses

- `480` — InternalServerException
- `481` — AccessDeniedException
- `482` — ThrottlingException
- `483` — ValidationException

---

[API](https://skmtc.net/aws/apis/iottwinmaker.md) · [All operations](https://skmtc.net/aws/apis/iottwinmaker/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iottwinmaker/versions/a66a26fd65ea/schema)