Retrieve Transaction

Fetch details for a specific transaction.

GET /transactions/{transactionId}

This endpoint retrieves information about the transaction with the specified transactionId.

Authorizations

Authorization · Required Header

A Stedi API Key for authentication.

Path Parameters

transactionId · String

A unique identifier for the processed transaction within Stedi. This ID is included in the transaction processed event. You can also retrieve it manually from the transaction's details page within the Stedi portal.

Response

application/json

GetTransaction 200 response

transactionId · String Required

A unique identifier for the processed transaction within Stedi. This ID is included in the transaction processed event. You can also retrieve it manually from the transaction's details page within the Stedi portal.

fileExecutionId · String Required

A unique identifier for the processed file within Stedi. This ID is included in the transaction processed event. You can also retrieve it manually from the file's details page in the Stedi portal.

status · String Required

A status indicating whether Stedi was able to successfully process the transaction.

Possible values

failed

succeeded

direction · String Required

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

mode · String Required

Indicates whether the transaction contains test or production data. Stedi determines this from the value in ISA15 Usage Indicator Code.

Possible values

test

production

other

processedAt · String Required Format: date-time

The date and time when Stedi processed the transaction, in ISO 8601 format. For example, 2023-08-28T00:00:00Z.

artifacts · Array of Objects Required

A list of artifacts related to the transaction.

artifactType · artifacts[].artifactType · String Required

The format of the artifact.

Possible values

text/csv

application/edifact

application/filepart

application/json

application/pdf

usage · artifacts[].usage · String 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.

Possible values

attachment

input

metadata

output

sizeBytes · artifacts[].sizeBytes · Number Required

The size of the artifact in bytes.

url · artifacts[].url · String Required

A URL to download the artifact.

model · artifacts[].model · String 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.

Possible values

execution

fragment

transaction

fault

partnership · Object Required

Information about the associated partnership.

A partnership describes all aspects of the EDI relationship between two profiles in your Stedi account, such as which transaction sets they will exchange and other important information for processing EDI files. 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.

partnershipId · partnership.partnershipId · String Required Regex pattern: ^([a-zA-Z0-9._-]+)$ Length: 1 - 81

The unique identifier for the partnership within the Stedi platform.

A partnership describes all aspects of the EDI relationship between two profiles in your Stedi account, such as which transaction sets they will exchange and other important information for processing EDI files. If you're sending or receiving transactions through the Stedi clearinghouse, Stedi configures the necessary partnerships for you automatically when you set up your account.

partnershipType · partnership.partnershipType · String Required

The type of partnership, which determines the EDI standard used for exchanging transactions.

Possible values

x12

edifact

sender · partnership.sender · Object Required

The entity that initiated the transaction.

profileId · partnership.sender.profileId · String Required Regex pattern: ^([a-zA-Z0-9._-]+)$ Length: 1 - 40

A unique identifier for the profile within the Stedi platform.

receiver · partnership.receiver · Object Required

The entity that is receiving the transaction.

profileId · partnership.receiver.profileId · String Required Regex pattern: ^([a-zA-Z0-9._-]+)$ Length: 1 - 40

A unique identifier for the profile within the Stedi platform.

x12 · Object

Details about the X12 EDI transaction.

metadata · x12.metadata · Object Required

Metadata about the X12 EDI transaction, including information from the interchange, functional group, and transaction headers as well as the sender and receiver IDs.

interchange · x12.metadata.interchange · Object Required

Data from the Interchange Control Header of the X12 EDI file.

acknowledgmentRequestedCode · x12.metadata.interchange.acknowledgmentRequestedCode · String Required

The value of ISA14 in the Interchange Control Header, which indicates whether the sender is requesting a TA1 Interchange Acknowledgment.

controlNumber · x12.metadata.interchange.controlNumber · Number Required Range: ≥ 0 and ≤ 999999999

The control number in the Interchange Control Header.

functionalGroup · x12.metadata.functionalGroup · Object Required

Data from the Functional Group Header of the X12 EDI file.

controlNumber · x12.metadata.functionalGroup.controlNumber · Number Required Range: ≥ 0 and ≤ 999999999

The Group Control Number (GS06).

date · x12.metadata.functionalGroup.date · String Required

The date in the Functional Group Header (GS04), formatted as YYYY-MM-DD. For example, 2023-08-28.

functionalIdentifierCode · x12.metadata.functionalGroup.functionalIdentifierCode · String Required

The Functional Identifier Code (GS01), which indicates the type of transaction. For example, HC for an 837 Healthcare Claim.

time · x12.metadata.functionalGroup.time · String Required

The Time (GS05), formatted as HH:MM:SS. For example, 21:29:57.

release · x12.metadata.functionalGroup.release · String Required

The Version/Release/Industry Identifier Code (GS08), which indicates the version of the X12 standard used. For example, 005010X222A1.

transaction · x12.metadata.transaction · Object Required

Data from the Transaction Set Header of the X12 EDI file.

controlNumber · x12.metadata.transaction.controlNumber · String Required

The Transaction Set Control Number (ST02).

transactionSetIdentifier · x12.metadata.transaction.transactionSetIdentifier · String Required

The Transaction Set Identifier Code (ST01), which indicates the type of transaction. For example, 837 for an 837 Healthcare Claim.

sender · x12.metadata.sender · Object Required

The Application Code and ISA ID for the profile.

applicationCode · x12.metadata.sender.applicationCode · String Required

The Application Code for the profile, which is used to identify the entity in the GS header of an EDI file.

isa · x12.metadata.sender.isa · Object Required

The Interchange ID and qualifier.

qualifier · x12.metadata.sender.isa.qualifier · String Required

The Interchange Sender ID Qualifier, which indicates the type of identifier. For example, ZZ for a mutually defined identifier.

id · x12.metadata.sender.isa.id · String Required

The Interchange ID, which is the unique identifier for the entity in the EDI file.

receiver · x12.metadata.receiver · Object Required

The Application Code and ISA ID for the profile.

applicationCode · x12.metadata.receiver.applicationCode · String Required

The Application Code for the profile, which is used to identify the entity in the GS header of an EDI file.

isa · x12.metadata.receiver.isa · Object Required

The Interchange ID and qualifier.

qualifier · x12.metadata.receiver.isa.qualifier · String Required

The Interchange Sender ID Qualifier, which indicates the type of identifier. For example, ZZ for a mutually defined identifier.

id · x12.metadata.receiver.isa.id · String Required

The Interchange ID, which is the unique identifier for the entity in the EDI file.

transactionSetting · x12.transactionSetting · Object

The IDs for the guide and transaction setting Stedi used to process the transaction.

guideId · x12.transactionSetting.guideId · String

The unique identifier for the Stedi guide used to process the transaction.

Stedi guides are machine-readable specifications for X12 EDI transactions. They describe how to structure and validate EDI files for each transaction type.

transactionSettingId · x12.transactionSetting.transactionSettingId · String

The unique identifier for the transaction setting Stedi used to process the transaction.

Transaction settings configure how Stedi processes specific transaction types, such as which Stedi guide to use and other processing options. If you're using the Stedi clearinghouse, Stedi automatically configures the required transaction settings for you when you set up your account.

fragments · Object

Details about fragments included in the transaction, if applicable. Fragments break large transactions into smaller parts for easier processing and management.

keyName · fragments.keyName · String Required

The JSON schema key name for the segment in the Stedi guide used to split the transaction into fragments. For example, in an 834 Health Care Benefit Enrollment and Maintenance, this would be member_level_detail_INS_loop.

fragmentCount · fragments.fragmentCount · Number Required

The total number of fragments in the transaction.

batchSize · fragments.batchSize · Number Required

The maximum size of each fragment in kilobytes (KB). Stedi uses this to automatically split large inbound transactions into fragments.

translationErrors · Array of Objects

Details about errors that prevented Stedi from processing the transaction.

context · translationErrors[].context · Object

code · translationErrors[].context.code · String

The error code.

schemaPath · translationErrors[].context.schemaPath · String

The name of the JSON property where the error occurred.

mark · translationErrors[].mark · Object

The location in the document where the problem occurred. May be a single index or a range.

start · translationErrors[].mark.start · Object Required

line · translationErrors[].mark.start.line · Number Required

The line number in the document where the problem occurred.

column · translationErrors[].mark.start.column · Number Required

The column number in the document where the problem occurred.

end · translationErrors[].mark.end · Object

line · translationErrors[].mark.end.line · Number Required

The line number in the document where the problem occurred.

column · translationErrors[].mark.end.column · Number Required

The column number in the document where the problem occurred.

message · translationErrors[].message · String Required

A message describing the error that occurred during translation.

businessIdentifiers · Array of Objects

Any business identifiers extracted from the transaction.

elementId · businessIdentifiers[].elementId · String Required

The identifier of the element containing the business identifier in the EDI specification.

element · businessIdentifiers[].element · String Required

The element where the business identifier was found. For example, BHT03 for 837 claims.

name · businessIdentifiers[].name · String Required

The friendly name of the business identifier. For example, Originator Application Transaction Identifier.

value · businessIdentifiers[].value · String Required

The value of the business identifier.

cURL

curl --request GET \
  --url "https://core.us.stedi.com/2023-08-01/transactions/{transactionId}" \
  --header "Authorization: <api_key>"

JavaScript

fetch("https://core.us.stedi.com/2023-08-01/transactions/{transactionId}", {
  headers: {
    "Authorization": "<api_key>"
  }
})

Go

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://core.us.stedi.com/2023-08-01/transactions/{transactionId}"

  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "<api_key>")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}

Python

import requests

url = "https://core.us.stedi.com/2023-08-01/transactions/{transactionId}"

response = requests.request("GET", url, headers = {
  "Authorization": "<api_key>"
})

print(response.text)

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
import java.time.Duration;

HttpClient client = HttpClient.newBuilder()
  .connectTimeout(Duration.ofSeconds(10))
  .build();

HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
  .uri(URI.create("https://core.us.stedi.com/2023-08-01/transactions/{transactionId}"))
  .header("Authorization", "<api_key>")
  .GET()
  .build();

try {
  HttpResponse<String> response = client.send(requestBuilder.build(), BodyHandlers.ofString());
  System.out.println("Status code: " + response.statusCode());
  System.out.println("Response body: " + response.body());
} catch (Exception e) {
  e.printStackTrace();
}

200

{
  "direction": "INBOUND",
  "mode": "test",
  "status": "succeeded",
  "fileExecutionId": "95236a56-a020-4522-8fef-bcffcec0ec1d",
  "transactionId": "c8dd3a67-b8ca-4b0e-aa73-e0de82414b8f",
  "processedAt": "2025-04-02T21:30:15.801Z",
  "artifacts": [
    {
      "artifactType": "application/edi-x12",
      "sizeBytes": 8374,
      "model": "transaction",
      "usage": "input",
      "url": "https://core.us.stedi.com/2023-08-01/transactions/c8dd1111-b8ca-4330e-aa73-e0de33314b8f/input"
    },
    {
      "artifactType": "application/json",
      "sizeBytes": 76898,
      "model": "transaction",
      "usage": "output",
      "url": "https://core.us.stedi.com/2023-08-01/transactions/c8dd3a67-b8ca-4b0e-kk73-55667882414b8f/output"
    }
  ],
  "partnership": {
    "partnershipId": "stedi_test-sender",
    "partnershipType": "x12",
    "sender": {
      "profileId": "test-sender"
    },
    "receiver": {
      "profileId": "stedi"
    }
  },
  "businessIdentifiers": [
    {
      "elementId": "127",
      "element": "BHT-03",
      "name": "Reference Identification",
      "value": "XXXXXX"
    }
  ],
  "x12": {
    "metadata": {
      "interchange": {
        "acknowledgmentRequestedCode": "0",
        "controlNumber": 1
      },
      "functionalGroup": {
        "controlNumber": 1,
        "release": "005010X222A1",
        "date": "2025-04-02",
        "time": "21:29:57",
        "functionalIdentifierCode": "HC"
      },
      "transaction": {
        "controlNumber": "0001",
        "transactionSetIdentifier": "837"
      },
      "receiver": {
        "applicationCode": "STEDI-TEST",
        "isa": {
          "qualifier": "ZZ",
          "id": "STEDI-TEST"
        }
      },
      "sender": {
        "applicationCode": "TestSender",
        "isa": {
          "qualifier": "ZZ",
          "id": "TestSender"
        }
      }
    },
    "transactionSetting": {
      "guideId": "01JQW6E5RSBSTKS3ZQ1SPR4019",
      "transactionSettingId": "01JQW6E72Q3HDXM40YYAQCBZDY"
    }
  }
}

400

{
  "message": "string",
  "code": "string"
}

401

{
  "message": "string",
  "code": "string"
}

403

{
  "message": "string",
  "code": "string"
}

404

{
  "message": "string",
  "code": "string"
}

409

{
  "message": "string"
}

429

{
  "message": "string",
  "code": "string"
}

500

{
  "message": "string",
  "cause": {
    "name": "string",
    "message": "string",
    "stack": "string"
  }
}

503

{
  "message": "string",
  "code": "string"
}

504

{
  "message": "string",
  "code": "string"
}