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

# GET /pg-executions/{executionId}/faults

`GET /pg-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](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.

## 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`

PgListExecutionFaults 200 response

- PgListExecutionFaultsResponseContent
  - `nextPageToken` string — The token used for pagination
  - `items` ExecutionFault[], required
    - `createdAt` string, date-time, required
    - `id` string, required
    - `executionId` string, required
    - `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
    - `faultMessage` string, required
    - `guideId` string
    - `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
      - `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
      - `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', required
      - `usage` 'attachment' | 'input' | 'metadata' | 'output', required
      - `sizeBytes` number, required
      - `url` string, required
      - `model` 'execution' | 'fragment' | 'transaction' | 'fault', 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 `items/items/artifacts/items/usage` response property for the response status `200`
  - added the new `image/jpeg` enum value to the `items/items/artifacts/items/artifactType` response property for the response status `200`
  - added the new `image/png` enum value to the `items/items/artifacts/items/artifactType` response property for the response status `200`
  - added the new `image/tiff` enum value to the `items/items/artifacts/items/artifactType` response property for the response status `200`
  - …1 more
- **2025-04-15** `a1d3c59f4996` — 8 info
  - added the optional property `items/items/receiverProfile/applicationId` to the response with the `200` status
  - added the optional property `items/items/senderProfile/applicationId` to the response with the `200` status
  - added the required property `items/items/receiverProfile/interchangeId` to the response with the `200` status
  - added the required property `items/items/receiverProfile/interchangeQualifier` to the response with the `200` status
  - …4 more
- **2025-03-04** `17229129dd99` — 1 info
  - added the optional property `items/items/release` to the response with the `200` status
- **2025-02-10** `04e056fede93` — 1 info
  - added the optional property `items/items/artifacts` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/stedi/apis/core/changes/pg-executions/:executionId/faults/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)