---
title: "GET /executions/{executionId}"
method: GET
path: "/executions/{executionId}"
---

# GET /executions/{executionId}

`GET /executions/{executionId}`

Retrieve the file execution details for a given executionId.

## Path parameters

- `executionId` string, required — A unique identifier for the file execution within Stedi. This ID is included in the [file processed event](https://www.stedi.com/docs/edi-platform/operate/event-types#file-processed), or you can retrieve it manually from the file's details page within the Stedi app.

## Response `200`

GetExecution 200 response

- GetExecutionResponseContent
  - `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
  - `artifacts` Artifact[]
    - `artifactType` 'text/csv' | 'application/edifact' | 'application/filepart' | 'application/json' | 'application/pdf' | 'text/psv' | 'text/tsv' | 'application/edi-x12' | 'application/xml' | 'application/zip' | 'image/jpeg' | 'image/png' | 'image/tiff' | 'text/plain', required
    - `usage` 'attachment' | 'input' | 'metadata' | 'output', required
    - `sizeBytes` number, required
    - `url` string, required
    - `model` 'execution' | 'fragment' | 'transaction' | 'fault', required
  - `deliveryReports` DeliveryReport[]
    - `createdAt` string, date-time, required
    - `id` string, required
    - `executionId` string, required
    - `partnershipId` string, required
    - `connectionType` 'bucket' | 'remote-ftp' | 'stedi-ftp' | 'as2', required
    - `connectionId` string, required — Autogenerated identifier for a connection
    - `attempt` number, required
    - `filename` string, required
    - `status` 'FAILED' | 'DELIVERED', required
    - `message` string, required
    - `metadata` DeliveryReportMetadata
      - `attempts` number
      - `mdn_file` MdnFile
        - `repository` string, required
        - `pointer` string, required

## 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-04-22** `4446f4193c6b` — 5 warning
  - added the new `attachment` enum value to the `artifacts/items/usage` response property for the response status `200`
  - added the new `image/jpeg` enum value to the `artifacts/items/artifactType` response property for the response status `200`
  - added the new `image/png` enum value to the `artifacts/items/artifactType` response property for the response status `200`
  - added the new `image/tiff` enum value to the `artifacts/items/artifactType` response property for the response status `200`
  - …1 more
- **2025-03-27** `465399797588` — 1 breaking, 2 info
  - the `deliveryReports/items/metadata` response's property type/format changed from `string`/`` to `object`/`` for status `200`
  - added the optional property `deliveryReports/items/metadata/attempts` to the response with the `200` status
  - added the optional property `deliveryReports/items/metadata/mdn_file` to the response with the `200` status
- **2025-02-28** `2e4ed843c334` — 1 info
  - added the required property `source/dirname` to the response with the `200` status
- **2025-02-05** `5cd01e1d1679` — 1 warning
  - added the new `fault` enum value to the `artifacts/items/model` response property for the response status `200`
- **2024-12-18** `6e04e598f826` — 1 info
  - the `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/:executionId/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)