GET
/
executions
curl --request GET \
  --url https://core.us.stedi.com/2023-08-01/executions \
  --header 'Authorization: <api-key>'
{
  "items": [
    {
      "createdAt": "2025-04-04T17:14:35.481Z",
      "direction": "INBOUND",
      "executionId": "55907f88-999e-4912-9e9b-78326f8bade8",
      "faultCount": 0,
      "partnershipId": "local-clearinghouse-test",
      "source": {
        "dirname": ".",
        "name": "test-inbound-ingest-30848232-fa0c-4151-8217-d03205e806f9.edi"
      },
      "retryable": true,
      "status": "COMPLETED",
      "transactionCount": 1,
      "updatedAt": "2025-04-04T17:14:42.854Z"
    },
    {
      "createdAt": "2025-04-02T21:30:08.387Z",
      "direction": "INBOUND",
      "executionId": "95236a56-a020-4522-8fef-bcffcec0ec1d",
      "faultCount": 0,
      "partnershipId": "local-clearinghouse-test",
      "source": {
        "dirname": ".",
        "name": "test-inbound-ingest-3f2efd94-2a81-4b57-b4de-9b970a50db60.edi"
      },
      "retryable": true,
      "status": "COMPLETED",
      "transactionCount": 1,
      "updatedAt": "2025-04-02T21:30:16.185Z"
    },
    {
      "createdAt": "2025-02-28T19:16:26.041Z",
      "direction": "OUTBOUND",
      "executionId": "06bdccdc-4ab9-4add-b1dc-a76a0183f299",
      "faultCount": 0,
      "partnershipId": "local-clearinghouse-test",
      "source": {
        "dirname": "f894c51a-14639/to-stedi",
        "name": "837-clearinghouse_outbound.edi"
      },
      "retryable": true,
      "status": "COMPLETED",
      "transactionCount": 1,
      "updatedAt": "2025-02-28T19:16:27.706Z"
    }
  ],
  "nextPageToken": "eyJwYWdlIjoxLCJwYWdlU2l6ZSI6MTAsInBhZ2VUb3RhbCI6MzE0fQ=="
}

This endpoint retrieves information about all file executions that Stedi has processed in your account. It’s useful for displaying a list of processed files in a UI. If you want to programmatically fetch and check for new file executions, you should use the Poll Executions endpoint instead.

Authorizations

​
Authorization
string
header
required

A Stedi API Key for authentication.

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.

Required range: x >= 1
​
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.

Required string length: 1 - 1024
​
direction
enum<string>

The direction of the transaction. Inbound transactions are those you receive from a payer, provider, or other trading partner. Outbound transactions are those you send to a payer, provider, or other trading partner.

Available options:
INBOUND,
OUTBOUND,
UNKNOWN
​
faultCode
enum<string>

A code specifying the reason for the fault.

Available options:
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
​
partnershipId
string
​
status
enum<string>

The status of the execution. An execution is COMPLETED when Stedi has finished processing the file with no errors. If the file is an outbound file, a COMPLETED status also means that Stedi successfully delivered it to the configured connection.

Available options:
COMPLETED,
PARTIALLY_COMPLETED,
FAILED,
IGNORED,
IN_PROGRESS,
RETRYING,
RETRIED,
STARTED
​
from
string
​
to
string

Response

200
application/json

ListExecutions 200 response

Common output structure for list operations with pagination support.