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

# GET /executions/{executionId}/faults

`GET /executions/{executionId}/faults`

Fetch a list of faults for a given file execution, sorted by the date they were created from newest to oldest.

## Path parameters

- `executionId` string, required — A unique identifier for the file execution within Stedi. This ID is included in the file processed event, or you can retrieve it manually from the file's details page within the Stedi portal.

## Query parameters

- `pageSize` number — The maximum number of elements to return in a page. If not specified, the default is 100.
- `pageToken` string — `pageToken` is an opaque token returned by a previous call to this operation in the `nextPageToken`

## Response `200`

ListExecutionFaults 200 response

- ListExecutionFaultsResponseContent — Common output structure for list operations with pagination support.
  - `nextPageToken` string — Token that you can supply in subsequent requests to retrieve the next page of results. If not returned, there are no more results.
  - `items` ExecutionFault[], required
    - `createdAt` string, date-time, required — The date and time when the resource was created, in ISO 8601 format. For example, `2023-08-28T00:00:00Z`.
    - `id` string, required
    - `executionId` string, required — A unique identifier for the processed file within Stedi.
    - `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', required — A code specifying the reason for the fault. This code appears in the `code` property of the HTTP error response.
    - `faultMessage` string, required
    - `guideId` string — The unique identifier for the Stedi guide used to process the transactions in the file. Stedi guides are machine-readable specifications that describe how to structure and validate EDI files for each transaction type.
    - `receiverProfile` ExecutionPartnershipProfile
      - `interchangeQualifier` '01' | '02' | '03' | '04' | '07' | '08' | '09' | '10' | '11' | '12' | '13' | '14' | '15' | '16' | '17' | '18' | '19' | '20' | '21' | '22' | '23' | '24' | '25' | '26' | '27' | '28' | '29' | '30' | '31' | '32' | '33' | '34' | '35' | '36' | '37' | '38' | 'AM' | 'NR' | 'SA' | 'SN' | 'ZZ', required
      - `interchangeId` string, required
      - `profileId` string, required — A unique identifier for the profile within the Stedi platform.
      - `profileType` 'local' | 'partner', required
      - `applicationId` string
    - `senderProfile` ExecutionPartnershipProfile
      - `interchangeQualifier` '01' | '02' | '03' | '04' | '07' | '08' | '09' | '10' | '11' | '12' | '13' | '14' | '15' | '16' | '17' | '18' | '19' | '20' | '21' | '22' | '23' | '24' | '25' | '26' | '27' | '28' | '29' | '30' | '31' | '32' | '33' | '34' | '35' | '36' | '37' | '38' | 'AM' | 'NR' | 'SA' | 'SN' | 'ZZ', required
      - `interchangeId` string, required
      - `profileId` string, required — A unique identifier for the profile within the Stedi platform.
      - `profileType` 'local' | 'partner', required
      - `applicationId` string
    - `translateFaultContext` unknown
    - `transactionSetIdentifier` string
    - `release` 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' | 'unknown', required — The format of the artifact.
      - `usage` 'attachment' | 'input' | 'metadata' | 'output', required — The type of data the artifact contains. For example, an input artifact represents the original data Stedi received before processing, while an output artifact represents the processed data. For example, for an inbound 835 ERA from a payer, the input artifact would be the original X12 EDI, and the output artifact would be the JSON representation of the ERA.
      - `sizeBytes` number, required — The size of the artifact in bytes.
      - `url` string, required — A URL to download the artifact.
      - `model` 'execution' | 'fragment' | 'transaction' | 'fault', required — The model of the artifact, which indicates the type of process or operation it represents. For example, an execution artifact represents a file that was processed, a fragment artifact represents a part of a larger transaction, and a fault artifact represents an error that occurred during processing.

## Other responses

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

---

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