GET
/
transactions
cURL
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

List only transactions containing a business identifier with the given value.

​
transactionSetId
enum<string>

List only a given type of transaction. Accepts any valid 3-digit X12 Transaction Set Identifier Code, as defined in the X12 standard. See: https://www.stedi.com/edi/x12/element/143.

Available options:
100,
101,
102,
103,
104,
105,
106,
107,
108,
109,
110,
111,
112,
113,
120,
121,
124,
125,
126,
127,
128,
129,
130,
131,
132,
133,
135,
138,
139,
140,
141,
142,
143,
144,
146,
147,
148,
149,
150,
151,
152,
153,
154,
155,
157,
158,
159,
160,
161,
163,
170,
175,
176,
179,
180,
185,
186,
187,
188,
189,
190,
191,
194,
195,
196,
197,
198,
199,
200,
201,
202,
203,
204,
205,
206,
210,
211,
212,
213,
214,
215,
216,
217,
219,
220,
222,
223,
224,
225,
227,
228,
240,
242,
244,
245,
248,
249,
250,
251,
252,
255,
256,
259,
260,
261,
262,
263,
264,
265,
266,
267,
268,
269,
270,
271,
272,
273,
274,
275,
276,
277,
278,
280,
283,
284,
285,
286,
288,
290,
300,
301,
303,
304,
309,
310,
311,
312,
313,
315,
317,
319,
322,
323,
324,
325,
326,
350,
352,
353,
354,
355,
356,
357,
358,
359,
361,
362,
404,
410,
412,
414,
417,
418,
419,
420,
421,
422,
423,
424,
425,
426,
429,
431,
432,
433,
434,
435,
436,
437,
440,
451,
452,
453,
455,
456,
460,
463,
466,
468,
470,
475,
485,
486,
490,
492,
494,
500,
501,
503,
504,
511,
517,
521,
527,
536,
540,
561,
567,
568,
601,
603,
620,
625,
650,
715,
753,
754,
805,
806,
810,
811,
812,
813,
814,
815,
816,
818,
819,
820,
821,
822,
823,
824,
826,
827,
828,
829,
830,
831,
832,
833,
834,
835,
836,
837,
838,
839,
840,
841,
842,
843,
844,
845,
846,
847,
848,
849,
850,
851,
852,
853,
854,
855,
856,
857,
858,
859,
860,
861,
862,
863,
864,
865,
866,
867,
868,
869,
870,
871,
872,
873,
874,
875,
876,
877,
878,
879,
880,
881,
882,
883,
884,
885,
886,
887,
888,
889,
890,
891,
892,
893,
894,
895,
896,
897,
920,
924,
925,
926,
928,
940,
943,
944,
945,
947,
980,
990,
993,
996,
997,
998,
999
​
sender
string

List only transactions sent by the given profile. This is the profile ID of the sender.

​
receiver
string

List only transactions sent to the given profile. This is the profile ID of the receiver.

​
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<date-time>
​
to
string<date-time>
​
elementId
string

List only transactions containing a business identifier with the given element ID. This is the X12 element ID, such as "127" for Reference Identification. May only be supplied if businessIdentifier is also supplied. See Stedi's EDI references pages to find element IDs.

​
partnershipId
string

List only transactions that were sent or received on the given partnership. This is the partnership ID, such as "local_clearinghouse-test".

Response

200
application/json

ListTransactions 200 response

Common output structure for list operations with pagination support.