module.exports = {
  extends: ["@stedi/eslint-config", "next/core-web-vitals"],
  plugins: ["@typescript-eslint", "prettier", "unused-imports"],
  parserOptions: {
    tsconfigRootDir: __dirname,
  },
  parser: "@typescript-eslint/parser",
  rules: {
    "@next/next/no-html-link-for-pages": ["off"],
  },
  ignorePatterns: [
    "/dist/",
    "out",
    "cdk.out",
    "node_modules",
    ".next",
    ".git",
    ".turbo",
  ],
  rules: {
    "prettier/prettier": "error",
    "no-unused-vars": "off",
    "unused-imports/no-unused-imports": "error",
    "unused-imports/no-unused-vars": [
      "warn",
      {
        vars: "all",
        varsIgnorePattern: "^_",
        args: "after-used",
        argsIgnorePattern: "^_",
      },
    ],
  },
  overrides: [
    {
      files: ["lib/**/*.ts"],
      rules: {
        "@next/next/no-img-element": "off",
        "prefer-const": "error",
        "@typescript-eslint/no-floating-promises": "error",
      },
      parserOptions: {
        project: "./tsconfig.json",
      },
    },
    {
      files: "scripts/**/*.ts",
      parserOptions: {
        project: "scripts/tsconfig.json",
      },
      rules: {
        "simple-import-sort/imports": "off",
        "compat/compat": "off",
        "global-require": "off",
        "no-await-in-loop": "off",
        "no-console": "off",
        "import/order": [
          "error",
          {
            "newlines-between": "always",
          },
        ],
      },
    },
  ],
};


Changelog

Stedi

Healthcare

EDI platform

API Reference

Get started

Open Stedi

Acceptable Use Policy

Turn-key APIs for real-time connectivity across the healthcare industry

Overview

Stedi Healthcare

Learn more about Stedi's Change Healthcare replacement APIs

Change Healthcare FAQ

What is an eligibility check?

Eligibility Checks 101

Check eligibility

Send eligibility checks with Stedi

Benefit response

271 Benefit Response

Errors and resolutions

Replacement for Change Healthcare (CHC) Claim Submission API

Claims

Send claims with Stedi

Platform overview

EDI platform overview

Gather requirements

Integration steps

Configuration overview

Partnerships

Connections overview

Choosing a connection type

Stedi SFTP/FTPS

Stedi SFTP/FTPS Connections

Remote SFTP/FTPS

Remote SFTP/FTPS Connections

Buckets

Bucket Connections

Transaction settings

Acknowledgments

Guides overview

What is an EDI guide?

Import guides

Import Stedi Guides

Share public guides

Public Guides

EDI settings

File processing overview

Parse EDI

Create outbound transaction

Customize the envelope

Customize the ISA and GS headers

Overview - Transform Guide JSON

Guide JSON format

Transformation approaches

Choose a transformation approach

Configure

Fragments: Split transactions into smaller chunks

Inbound files

Split inbound EDI files with fragments

Outbound files

Generate outbound EDI files with fragments

Monitor transactions

Events

Events types and structure

Destinations overview

Destinations

Configure webhooks

Error handling and limitations

Webhooks error handling and limitations

Mappings overview

Mappings - Transform JSON

Invoke

Invoke mappings

Limits

Mappings limits

Generate test files

Generate test files in your browser

Failures and retries

What is EDI?

What is an element?

What is an element in X12 EDI?

Elements - Requirements

Element Requirements in X12 EDI

Elements - Data types

Element data types in X12 EDI

Relational conditions

Relational conditions in X12 EDI

What is a segment?

What is a segment in X12 EDI?

Segments - Requirements

Segment requirements in X12 EDI

Segments - Repetition

Segment repetition in X12 EDI"

Glossary

HIPAA

X12 HIPAA

Accounts and billing

Cookie Notice

Customer Agreement

Privacy Notice

Service Terms

Site Terms

Data and privacy

HIPAA compliance

HIPAA compliance on Stedi

Support

Eligibility Check

Eligibility Check Raw X12

Professional Claims

Professional Claims Raw X12

Claim Status

Claims Status Raw X12 Enhanced

Claim Status Raw X12

This endpoint generates and delivers fully-formed EDI files containing a single transaction. It is the simplest way to generate EDI with Stedi.

Transaction

Create Outbound Transaction

This endpoint generates and delivers fully-formed EDI files to your trading partners.

Interchange

Create Outbound Interchange

Fetch a list of transactions, sorted by the date they were created from newest to oldest.
Generally this endpoint is used to display a list of transactions in a UI.
If you are looking to regularly fetch and check for new transactions for programmatic usage, you should use the `ListPollingTransactions` operation instead.

List transactions

List Transactions

This endpoint is used to regularly poll for new transactions that have been processed in Core.

You must define one of `startDateTime` or `pageToken` when making a request.

You may optionally define a `pageSize`. The minimum `pageSize` is 1, and the maximum `pageSize` is 1000. The default is 100.

`startDateTime` takes a string in ISO 8601 format. (ex: `2023-08-10T18:00:00Z`). 
`startDateTime` must be set to at least 1 minute in the past.

The results will contain transactions that occurred after this `startDateTime`. Starting from the oldest to newest transactions ordered by the `processedAt` field. Note, this is _exclusive_ of the `startDateTime`, a transaction occuring at exactly `2023-08-10T18:00:00Z` for instance, would not be included. In addition, there is a 15 second window where newly created transactions will not be included to account for any network latency or clock drifts within the systems to ensure you do not miss any transactions.

Each request will _always_ return a `nextPageToken`, regardless of whether there are new transactions or not.

We DO NOT recommend trying to roll your own polling strategy leveraging `startDateTime` only. There are edge cases around two transactions occuring at the _exact_ same time and being on the edge of a pagination which could cause you to miss one due to the exclusive nature of `startDateTime`. We recommend using `pageToken`'s instead.

When making subsequent polling requests (not initiating with `startDateTime`), the `pageToken` can be used to continue iterating through pages of transactions. Usage of the `pageToken` guaruntees you will not miss any transactions on the stream. If at any point there are no more new transactions in the `item` array, you will still receive a `nextPageToken`. Continue to use this token to poll for new transactions. Once there are new transactions, they will be returned in the `item` array.

`pageToken`'s you have retrieved can serve as checkpoints. They do not expire, and you can always start from that point in the transaction stream again if you need to catch a system up or recover from a failure. Storing `pageToken`'s as part of your polling process is encouraged.

`pageToken`'s are unique per request, opaque, and should not be parsed or modified in any way. They are not guaranteed to be in any particular format, and may change in the future.


Poll transactions

Get Transaction

This endpoint is used to retrieve a transaction's input document before it passes through any translation and mappings, generally this will be EDI.

This endpoint returns a 302 Temporary redirect to the document download URL. Many HTTP clients will automatically follow this redirect, or have a simple follow redirects configuration to set. For instance in `curl` using the `-L` or `--location` flag will automatically follow the redirect.

In the event you cannot, or chose not to automatically follow the redirect, the body of the response contains a JSON object with a single key `documentDownloadUrl` which contains a temporary URL to download the document. This URL is good for 60 minutes.

There are no size restrictions on documents when fetching from this endpoint.


Input

Get Transaction Input

This endpoint is used to retrieve a transaction's output document after it has been translated via Core. Generally this will be JSON.

This endpoint returns a 302 Temporary redirect to the document download URL. Many HTTP clients will automatically follow this redirect, or have a simple follow redirects configuration to set. For instance in `curl` using the `-L` or `--location` flag will automatically follow the redirect.

In the event you cannot, or chose not to automatically follow the redirect, the body of the response contains a JSON object with a single key `documentDownloadUrl` which contains a temporary URL to download the document. This URL is good for 60 minutes.

There are no size restrictions on documents when fetching from this endpoint.


Output

Get Transaction Output

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

List executions

List Executions

This endpoint is used to regularly poll for new executions that have been processed by Stedi.

You must define one of `startDateTime` or `pageToken` when making a request.

You may optionally define a `pageSize`. The minimum `pageSize` is 1, and the maximum `pageSize` is 1000. The default is 100.

`startDateTime` takes a string in ISO 8601 format. (ex: `2023-08-10T18:00:00Z`). 
`startDateTime` must be set to at least 1 minute in the past.

The results will contain executions that occurred after this `startDateTime`. Starting from the oldest to newest executions ordered by the `processedAt` field. Note, this is _exclusive_ of the `startDateTime`, a execution occuring at exactly `2023-08-10T18:00:00Z` for instance, would not be included. In addition, there is a 15 second window where newly created executions will not be included to account for any network latency or clock drifts within the systems to ensure you do not miss any executions.

Each request will _always_ return a `nextPageToken`, regardless of whether there are new executions or not.

We DO NOT recommend trying to roll your own polling strategy leveraging `startDateTime` only. There are edge cases around two executions occuring at the _exact_ same time and being on the edge of a pagination which could cause you to miss one due to the exclusive nature of `startDateTime`. We recommend using `pageToken`'s instead.

When making subsequent polling requests (not initiating with `startDateTime`), the `pageToken` can be used to continue iterating through pages of executions. Usage of the `pageToken` guaruntees you will not miss any executions on the stream. If at any point there are no more new executions in the `item` array, you will still receive a `nextPageToken`. Continue to use this token to poll for new executions. Once there are new executions, they will be returned in the `item` array.

`pageToken`'s you have retrieved can serve as checkpoints. They do not expire, and you can always start from that point in the execution stream again if you need to catch a system up or recover from a failure. Storing `pageToken`'s as part of your polling process is encouraged.

`pageToken`'s are unique per request, opaque, and should not be parsed or modified in any way. They are not guaranteed to be in any particular format, and may change in the future.


Poll executions

Poll Executions

Fetch a list of transactions for a given file execution, sorted by the date they were created from newest to oldest. Includes the full transaction details.

List execution transactions

Get Execution Transactions

Retrieve the file execution details for a given executionId.

Execution

Get Execution

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 a 302 Temporary redirect to the document download URL. Many HTTP clients will automatically follow this redirect, or have a simple follow redirects configuration to set. For instance in `curl` using the `-L` or `--location` flag will automatically follow the redirect.

In the event you cannot, or chose not to automatically follow the redirect, the body of the response contains a JSON object with a single key `documentDownloadUrl` which contains a temporary URL to download the document. This URL is good for 60 minutes.

There are no size restrictions on documents when fetching from this endpoint.


Get Execution Input

This endpoint is used to retrieve an execution's metadata document.

This endpoint returns a 302 Temporary redirect to the document download URL. Many HTTP clients will automatically follow this redirect, or have a simple follow redirects configuration to set. For instance in `curl` using the `-L` or `--location` flag will automatically follow the redirect.

In the event you cannot, or chose not to automatically follow the redirect, the body of the response contains a JSON object with a single key `documentDownloadUrl` which contains a temporary URL to download the document. This URL is good for 60 minutes.

There are no size restrictions on documents when fetching from this endpoint.


Metadata

Get Execution Metadata

This endpoint is used to retrieve an execution's output document.

This endpoint returns a 302 Temporary redirect to the document download URL. Many HTTP clients will automatically follow this redirect, or have a simple follow redirects configuration to set. For instance in `curl` using the `-L` or `--location` flag will automatically follow the redirect.

In the event you cannot, or chose not to automatically follow the redirect, the body of the response contains a JSON object with a single key `documentDownloadUrl` which contains a temporary URL to download the document. This URL is good for 60 minutes.

There are no size restrictions on documents when fetching from this endpoint.


Get Execution Output

This endpoint stages a fragment for outbound delivery.

Stage fragment

Fetch a fragment by its index for a given transaction.

Fragment

Get Fragment

This endpoint is used to retrieve a transaction fragment's output document after it has been translated via Core. Generally this will be JSON.

This endpoint returns a 302 Temporary redirect to the document download URL. Many HTTP clients will automatically follow this redirect, or have a simple follow redirects configuration to set. For instance in `curl` using the `-L` or `--location` flag will automatically follow the redirect.

In the event you cannot, or chose not to automatically follow the redirect, the body of the response contains a JSON object with a single key `documentDownloadUrl` which contains a temporary URL to download the document. This URL is good for 60 minutes.

There are no size restrictions on documents when fetching from this endpoint, however they are generally smaller and consumable by nature of being a fragment.


Get Fragment Output

Maps the provided JSON to a different shape according to the specified mapping definition.

How-to guides

Administrative

Acceptable Use Policy