List Executions

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

GET /executions

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 · Required Header

A production Stedi API Key for authentication.

Query Parameters

pageSize · Number Range : ≥ 1

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 Length : 1 - 1024

An opaque token returned by a previous call to this operation in the nextPageToken. If not specified, Stedi returns the first page of results.

direction · 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.

Possible values

INBOUND

OUTBOUND

UNKNOWN

faultCode · String

A code specifying the reason for the fault. This code appears in the code property of the HTTP error response.

Possible values

DELIVERY_FAILURE

FAILED_TO_EXTRACT_BUSINESS_IDENTIFIERS

FAILED_TO_FIND_GUIDE

FAILED_TO_FIND_LOCAL_PROFILE

FAILED_TO_FIND_PARTNER_PROFILE

partnershipId · String

The unique identifier for the partnership within the Stedi platform. If you're sending or receiving transactions through the Stedi clearinghouse, Stedi configures the necessary partnership for you automatically when you set up your account.

status · String

The status of the execution.

• You can only retry executions with a FAILED or IGNORED status.
• 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.

Possible values

COMPLETED

PARTIALLY_COMPLETED

FAILED

IGNORED

IN_PROGRESS

mode · String

Indicates whether the file execution contains test or production data. Stedi determines this from the value in ISA15 (Usage Indicator Code).

Possible values

test

production

other

unknown

from · String Format : date-time

The start of the time range to filter file executions. The results will include executions created at or after this timestamp.

to · String Format : date-time

The end of the time range to filter file executions. The results will include executions up to and including this timestamp.

displayName · String Min length : 3

Filter executions by the source of the file, including the directory and file name. Supports partial matching against the full path.

Response

application/json

nextPageToken · String Length : 1 - 1024

Token that you can supply in subsequent requests to retrieve the next page of results. If not returned, there are no more results.

items · Array of Objects Required

The processed executions that match the request criteria. The items array is empty if there are no matching executions.

Request

curl --request GET \
  --url "https://core.us.stedi.com/2023-08-01/executions?pageSize=200" \
  --header "Authorization: <api_key>"

Response

{
  "items": [
    {
      "createdAt": "2025-04-04T17:14:35.481Z",
      "direction": "INBOUND",
      "executionId": "55907f88-999e-4912-9e9b-78326f8bade8",
      "faultCount": 0,
      "mode": "production",
      "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,
      "mode": "production",
      "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,
      "mode": "production",
      "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=="
}