GET
/
transactions
curl --request GET \
  --url https://core.us.stedi.com/2023-08-01/transactions \
  --header 'Authorization: <api-key>'
{
  "items": [
    {
      "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/112233344-b8ca-4h1e-aa73-123482414b8f/input"
        },
        {
          "artifactType": "application/json",
          "sizeBytes": 76898,
          "model": "transaction",
          "usage": "output",
          "url": "https://core.us.stedi.com/2023-08-01/transactions/1115555-b8ca-1234-aa73-e0je82414hb8f/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"
        }
      }
    }
  ],
  "nextPageToken": "be08e5ba4bf36da9da27dcb651e64a6e5502685499994f354"
}

This endpoint fetches a list of all the transactions Stedi has processed in your account. It’s useful for displaying a list of transactions in a UI. If you want to programmatically fetch and check for new transactions, you should use the Poll Transactions 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: 1 <= x <= 500
​
pageToken
string

A 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
​
businessIdentifier
string

businessIdentifier may be passed to list only transactions matching the businessIdentifier.

​
transactionSetId
string

transactionSetId may be passed to list only a given type of transaction.

​
sender
string
​
receiver
string
​
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
​
mode
enum<string>

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

Available options:
test,
production,
other
​
status
enum<string>

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

Available options:
failed,
succeeded
​
from
string
​
to
string
​
elementId
string
​
partnershipId
string

Response

200
application/json

ListTransactions 200 response

Common output structure for list operations with pagination support.