---
title: "GET /executions"
method: GET
path: "/executions"
---

# GET /executions

`GET /executions`

Fetch a list of executions, sorted by the date they were created from newest to oldest.

## Query parameters

- `pageSize` number — The maximum number of elements to return in a page. You can set this to a maximum of 500 elements. If not specified, the default is 100.
- `pageToken` string — An opaque token returned by a previous call to this operation in the `nextPageToken`. If not specified, Stedi returns the first page of results.

## Response `200`

ListExecutions 200 response

- ListExecutionsResponseContent
  - `nextPageToken` string — The token used for pagination
  - `items` ExecutionSummary[], required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `executionId` string, required
    - `status` 'COMPLETED' | 'PARTIALLY_COMPLETED' | 'FAILED' | 'IGNORED' | 'IN_PROGRESS' | 'RETRYING' | 'RETRIED' | 'STARTED', required
    - `direction` 'INBOUND' | 'OUTBOUND' | 'UNKNOWN', required
    - `transactionCount` number
    - `faultCount` number
    - `faultCode` 'DELIVERY_FAILURE' | 'FAILED_TO_EXTRACT_BUSINESS_IDENTIFIERS' | 'FAILED_TO_FIND_GUIDE' | 'FAILED_TO_FIND_LOCAL_PROFILE' | 'FAILED_TO_FIND_PARTNER_PROFILE' | 'FAILED_TO_FIND_PARTNERSHIP' | 'FAILED_TO_FIND_PROFILES' | 'FAILED_TO_FIND_RECEIVER_PROFILE' | 'FAILED_TO_FIND_SENDER_PROFILE' | 'FAILED_TO_FIND_CONNECTION' | 'FAILED_TO_GENERATE_CONTROL_NUMBERS' | 'FAILED_TO_PARSE' | 'FAILED_TO_PARSE_METADATA' | 'FAILED_TO_TRANSLATE' | 'FAILED_TO_ACK' | 'FAILED_TO_ACK_INTERCHANGE' | 'FILE_NOT_FOUND' | 'INVALID_EVENT' | 'INVALID_CONFIGURATION' | 'MISMATCHED_PARTNERSHIP_CONNECTION' | 'MISSING_FUNCTIONAL_GROUP_CONTROL_NUMBER' | 'MISSING_FUNCTIONAL_GROUP_RELEASE' | 'MISSING_INTERCHANGE_CONTROL_NUMBER' | 'MISSING_TRANSACTION_SET_CONTROL_NUMBER' | 'MISSING_RECEIVER_ID' | 'MISSING_RECEIVER_QUALIFIER' | 'MISSING_SENDER_ID' | 'MISSING_SENDER_QUALIFIER' | 'MULTIPLE_MATCHING_GUIDES' | 'MULTIPLE_MATCHING_TRANSACTION_SETTINGS' | 'MULTIPLE_PARTNERSHIPS' | 'NO_TRANSLATION_OUTPUT' | 'NO_TRANSACTION_SETS' | 'NOT_SUPPORTED' | 'NO_FUNCTIONAL_GROUPS' | 'NO_USAGE_INDICATOR_CODE' | 'PREVIOUSLY_RETRIED' | 'TRANSLATION_ERROR' | 'UNKNOWN_ERROR'
    - `faultMessage` string
    - `fileType` 'CSV' | 'EDI/EDIFACT' | 'FILEPART' | 'JSON' | 'PSV' | 'JSON/STEDI-GUIDE' | 'TSV' | 'UNKNOWN' | 'EDI/X12' | 'XML' | 'ZIP'
    - `retryable` boolean
    - `parentExecutionId` string
    - `childExecutionId` string
    - `partnershipId` string — Identifier chosen by the user to uniquely identify a partnership.
    - `connectionType` 'bucket' | 'remote-ftp' | 'stedi-ftp' | 'as2'
    - `connectionId` string — Autogenerated identifier for a connection
    - `source` ExecutionSource
      - `dirname` string, required
      - `name` string, required
    - `operation` string

## Other responses

- `400` — ResourceUnderChangeException 400 response
- `401` — UnauthorizedException 401 response
- `403` — AccessDeniedException 403 response
- `404` — ResourceNotFoundException 404 response
- `429` — ThrottlingException 429 response
- `500` — ServiceException 500 response
- `503` — ServiceUnavailableException 503 response
- `504` — GatewayTimeoutException 504 response

## Changes

- **2025-02-28** `2e4ed843c334` — 1 info
  - added the required property `items/items/source/dirname` to the response with the `200` status
- **2024-12-18** `6e04e598f826` — 1 info
  - the `items/items/partnershipId` response's property pattern was changed from `^([a-zA-Z0-9_-]+)$` to `^([a-zA-Z0-9._-]+)$` for the status `200`

[Change history](https://skmtc.dev/stedi/apis/core/changes/executions/get.md)

---

[API](https://skmtc.dev/stedi/apis/core.md) · [All operations](https://skmtc.dev/stedi/apis/core/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stedi/core/revisions/4446f4193c6b/schema)