How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Stedi Executions API

The Executions API from Stedi — 11 operation(s) for executions.

Stedi Executions API is one of 25 APIs that Stedi publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Execution. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 11 operations across 11 paths, and defines 63 schemas. It is described by OpenAPI 3.2.0, at version 2023-08-01.

Requests are made against a single base URL, https://core.us.stedi.com/2023-08-01.

11 operations 11 paths 63 schemas 10 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2023-08-01
Base URL
https://core.us.stedi.com/2023-08-01
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Stedi Executions API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (httpApiKeyAuth). By default, every request must be authenticated.

  • httpApiKeyAuth — A [Stedi API Key](https://www.stedi.com/app/settings/api-keys) for authentication.

Paths & Operations 11

Across 11 paths, the API surfaces 11 operations — 10 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Executions 11
GET
/executions
Fetch a list of executions, sorted by the date they were created from newest to oldest.
ListExecutions 9 params → 200400401403404409422429
POST
/executions/retry
Queue file executions to be retried.
RetryExecutions body → 200400401403404409422429
GET
/executions/{executionId}
Retrieve the file execution details for a given executionId.
GetExecution 1 param → 200400401403404409422429
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.
ListExecutionFaults 3 params → 200400401403404409422429
GET
/executions/{executionId}/input
Fetch a file execution's input document before any translation and mappings.
GetExecutionInputDocument 1 param → 302400401403404409422429
GET
/executions/{executionId}/input-url
This endpoint is used to retrieve an execution's input document before it passes through any translation and mappings. Generally, this will be EDI. This endpoint returns the document download URL, it…
GetExecutionInputDocumentUrl 1 param → 200400401403404409422429
GET
/executions/{executionId}/metadata
Fetch a file execution's metadata document.
GetExecutionMetadataDocument 1 param → 302400401403404409422429
GET
/executions/{executionId}/metadata-url
This endpoint is used to retrieve a file execution's metadata document, limited to inbound/outbound x12 files. This endpoint returns the metadata document download URL, it must be then fetched for th…
GetExecutionMetadataDocumentUrl 1 param → 200400401403404409422429
GET
/executions/{executionId}/output
Fetch a file execution's output document. Only available for outbound files.
GetExecutionOutputDocument 1 param → 302400401403404409422429
GET
/executions/{executionId}/output-url
This endpoint is used to retrieve an execution's output document. This endpoint returns the document download URL, it must be then fetched for the actual document content. There are no size restricti…
GetExecutionOutputDocumentUrl 1 param → 200400401403404409422429
GET
/executions/{executionId}/transactions
Fetch a list of transactions for a file execution, including the full transaction details.
ListExecutionTransactions 3 params → 200400401403404409422429

Schemas 63

The contract defines 63 schemas that model the data the API accepts and returns. The most detailed are GetExecutionResponseContent (19 properties), ExecutionSummary (17 properties), ExecutionFault (12 properties), TransactionSummary (12 properties). Each schema is shown below with its type and property counts.

X12TransactionMetadataTransaction
object
Data from the Transaction Set Header of the X12 EDI file.
2 properties 2 required
MdnFile
object
The location of the Message Disposition Notification (MDN). This is only relevant for AS2 connections.
2 properties 2 required
ProfileType
string
GetExecutionMetadataDocumentResponseContent
object
1 property
ExecutionFaultCode
string
A code specifying the reason for the fault. This code appears in the code property of the HTTP error response.
UnauthorizedExceptionResponseContent
object
The server response when the authorizer failed to authenticate the caller.
2 properties 1 required
ArtifactModel
string
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 proces…
ServiceExceptionResponseContent
object
2 properties 1 required
ArtifactUsage
string
The type of data the artifact contains. For example, an input artifact represents the original data Stedi received before processing, while an output artifact…
TransactionStatus
string
A status indicating whether Stedi was able to successfully process the transaction.
TransactionFragmentsSummary
object
Details about fragments included in the transaction, if applicable. Fragments break large transactions into smaller parts for easier processing and management.
3 properties 3 required
ResourceUnderChangeExceptionResponseContent
object
1 property 1 required
ExecutionSummary
object
The processed executions that match the request criteria. The items array is empty if there are no matching executions.
17 properties 5 required
BadRequestExceptionResponseContent
object
The server cannot process the request due to an apparent client error.
2 properties 1 required
Index
object
2 properties 2 required
GetExecutionInputDocumentUrlResponseContent
object
1 property
ExecutionPartnershipProfile
object
5 properties 4 required
X12TransactionMetadataInterchange
object
Data from the Interchange Control Header of the X12 EDI file.
2 properties 2 required
TransactionSummary
object
The processed transactions that match the request criteria. The items array is empty if there are no matching transactions.
12 properties 8 required
RetryExecutionSelectionCondition
object
Specify the file executions to retry. Stedi will retry all executions matching the given criteria. For example, you can retry all file executions with a FAILED…
7 properties
Mark
object
The location in the document where the problem occurred. May be a single index or a range.
2 properties 1 required
GatewayTimeoutExceptionResponseContent
object
The server was acting as a gateway or proxy and did not receive a timely response from the upstream server.
2 properties 1 required
X12TransactionMetadataProfile
object
The Application Code and ISA ID for the profile.
2 properties 2 required
PartnershipReceiver
object
The entity that is receiving the transaction.
1 property 1 required
ServiceUnavailableExceptionResponseContent
object
The server cannot handle the request due to technical reasons.
2 properties 1 required
ListExecutionTransactionsResponseContent
object
Common output structure for list operations with pagination support.
2 properties 1 required
ExecutionSource
object
The source of the file, including the directory where Stedi received it and the file name.
2 properties 2 required
GetExecutionOutputDocumentResponseContent
object
1 property
FileType
string
The file format. For example, EDI/EDIFACT for an EDIFACT file or EDI/X12 for an X12 EDI file.
ArtifactType
string
The format of the artifact.
ExecutionFault
object
A failure to process a given file within stedi.
12 properties 5 required
UnprocessableEntityExceptionResponseContent
object
The request parameters do not match a previous request with the same idempotency key.
2 properties 1 required
X12TransactionMetadataFunctionalGroup
object
Data from the Functional Group Header of the X12 EDI file.
5 properties 5 required
ListExecutionsResponseContent
object
Common output structure for list operations with pagination support.
2 properties 1 required
X12TransactionSummary
object
Details about the X12 EDI transaction.
2 properties 1 required
DeliveryReportMetadata
object
Metadata about the file delivery.
2 properties
X12InterchangeQualifier
string
ThrottlingExceptionResponseContent
object
The server response when usage plan or account-level throttling limits exceeded.
2 properties 1 required
Partnership
object
Information about the associated partnership. A partnership describes all aspects of the EDI relationship between two profiles in your Stedi account, such as w…
4 properties 4 required
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…
PartnershipType
string
The type of partnership, which determines the EDI standard used for exchanging transactions.
X12TransactionMetadataProfileISA
object
The Interchange ID and qualifier.
2 properties 2 required
X12TransactionSetting
object
The IDs for the guide and transaction setting Stedi used to process the transaction.
2 properties
GetExecutionResponseContent
object
19 properties 5 required
GetExecutionMetadataDocumentUrlResponseContent
object
1 property
DeliveryReportStatus
string
CoreConnectionType
string
The type of connection used for file delivery.
ExceptionCause
object
3 properties
PartnershipSender
object
The entity that initiated the transaction.
1 property 1 required
X12TransactionMetadata
object
Metadata about the X12 EDI transaction, including information from the interchange, functional group, and transaction headers as well as the sender and receive…
5 properties 5 required
TranslationError
object
3 properties 1 required
BusinessIdentifier
object
4 properties 4 required
RetryExecutionsRequestContent
object
1 property 1 required
ListExecutionFaultsResponseContent
object
Common output structure for list operations with pagination support.
2 properties 1 required
ResourceNotFoundExceptionResponseContent
object
The server response when the specified resource cannot be found after an API request passes authentication and authorization.
2 properties 1 required
GetExecutionOutputDocumentUrlResponseContent
object
1 property
ExecutionStatus
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 th…
AccessDeniedExceptionResponseContent
object
The server response for authorization failure.
2 properties 1 required
Artifact
object
5 properties 5 required
DeliveryReport
object
11 properties 10 required
Mode
string
Indicates whether the transaction contains test or production data. Stedi determines this from the value in [ISA15 Usage Indicator Code](https://www.stedi.com/…
GetExecutionInputDocumentResponseContent
object
1 property
TranslationErrorContext
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

stedi-executions-api-openapi.yml Raw ↑

Other APIs Stedi publishes across the network.

Stedi Claim acknowledgments API
Stedi Claim Attachments API
Stedi Claim submission API
Stedi Coordination of benefits API
Stedi Documents API
Stedi Enrollments API
Stedi Events API
Stedi Fragments API
Stedi Insurance discovery API
Stedi Partnerships API
Stedi Payer API
Stedi Payers API
Where this information came from

This is an independent, third-party profile of Stedi Executions API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.